SuperHack

home *** CD-ROM | disk | FTP | other *** search

/ SuperHack / SuperHack CD.bin / CODING / GRAPHICS / XLIB612.ZIP / DOCS.ZIP / AMIPRO.ZIP / XLIBREF.SAM

(.txt)

Wrap

Ami Pro/Word Pro document | 1993-10-28 | 201.0 KB | 4,256 lines

[ver] [sty] _DEFAULT.STY [files] [charset] ANSI (Windows, IBM CP 1252) [revisions] [toc] Title Subhead Table Text [master] [prn] IBM Graphics [port] LPT1: [lang] [desc] 751837878 750467900 3561 [fopts] [lnopts] Body Text [docopts] [GramStyle] [ParaNum] [tag] TOCPG1 [fnt] Times New Roman 240 49155 [algn] [spc] 273 100 [brk] [line] [spec] [nfmt] 272 TOCPG1 [tag] TOC2 [fnt] Times New Roman 240 49152 [algn] 360 720 [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOC2 [tag] TOCPG2 [fnt] Times New Roman 240 49152 [algn] [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOCPG2 [tag] TOC3 [fnt] Times New Roman 240 49152 [algn] 720 1080 [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOC3 [tag] TOCPG3 [fnt] Times New Roman 240 49152 [algn] [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOCPG3 [tag] TOC4 [fnt] Times New Roman 240 49152 [algn] 1080 1440 [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOC4 [tag] TOCPG4 [fnt] Times New Roman 240 49152 [algn] [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOCPG4 [tag] TOC5 [fnt] Times New Roman 240 49152 [algn] 1440 1800 [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOC5 [tag] TOCPG5 [fnt] Times New Roman 240 49152 [algn] [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOCPG5 [tag] TOC6 [fnt] Times New Roman 240 49152 [algn] 1800 2160 [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOC6 [tag] TOCPG6 [fnt] Times New Roman 240 49152 [algn] [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOCPG6 [tag] TOC7 [fnt] Times New Roman 240 49152 [algn] 2160 2520 [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOC7 [tag] TOCPG7 [fnt] Times New Roman 240 49152 [algn] [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOCPG7 [tag] TOC8 [fnt] Times New Roman 240 49152 [algn] 2520 2880 [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOC8 [tag] TOCPG8 [fnt] Times New Roman 240 49152 [algn] [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOCPG8 [tag] TOC9 [fnt] Times New Roman 240 49152 [algn] 2880 3240 [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOC9 [tag] TOCPG9 [fnt] Times New Roman 240 49152 [algn] [spc] 273 100 [brk] [line] [spec] [nfmt] 280 TOCPG9 [tag] Table Text [fnt] Times New Roman 240 49152 [algn] [spc] 273 100 [brk] [line] [spec] [nfmt] 280 Table Text [frm] 68681924 1440 1440 10800 8179 1 0 0 0 0 0 0 16777215 0 29440 [frmlay] 1726 9360 1440 1584 10656 [tbl] 222 2 286 86 4569 86 1 43 43 [h] 0 286 86 2 0 2 0 1 286 86 2 0 2 0 2 286 86 2 0 2 0 3 286 86 2 0 2 0 4 286 86 2 0 2 0 5 286 86 2 0 2 0 6 286 86 2 0 2 0 7 286 86 2 0 2 0 8 286 86 2 0 2 0 9 286 86 2 0 2 0 10 286 86 2 0 2 0 11 286 86 2 0 2 0 12 286 86 2 0 2 0 13 286 86 2 0 2 0 14 286 86 2 0 2 0 15 286 86 2 0 2 0 16 286 86 2 0 2 0 17 286 86 2 0 2 0 18 286 86 2 0 2 0 19 286 86 2 0 2 0 20 286 86 2 0 2 0 21 286 86 2 0 2 0 22 286 86 2 0 2 0 23 286 86 2 0 2 0 24 286 86 2 0 2 0 25 286 86 2 0 2 0 26 286 86 2 0 2 0 27 286 86 2 0 2 0 28 286 86 2 0 2 0 29 286 86 2 0 2 0 30 286 86 2 0 2 0 31 286 86 2 0 2 0 32 286 86 2 0 2 0 33 286 86 2 0 2 0 34 286 86 2 0 2 0 35 286 86 2 0 2 0 36 286 86 2 0 2 0 37 286 86 2 0 2 0 38 286 86 2 0 2 0 39 286 86 2 0 2 0 40 286 86 2 0 2 0 41 286 86 2 0 2 0 42 286 86 2 0 2 0 43 286 86 2 0 2 0 44 286 86 2 0 2 0 45 286 86 2 0 2 0 46 286 86 2 0 2 0 47 286 86 2 0 2 0 48 286 86 2 0 2 0 49 286 86 2 0 2 0 50 286 86 2 0 2 0 51 286 86 2 0 2 0 52 286 86 2 0 2 0 53 286 86 2 0 2 0 54 286 86 2 0 2 0 55 286 86 2 0 2 0 56 286 86 2 0 2 0 57 286 86 2 0 2 0 58 286 86 2 0 2 0 59 286 86 2 0 2 0 60 286 86 2 0 2 0 61 286 86 2 0 2 0 62 286 86 2 0 2 0 63 286 86 2 0 2 0 64 286 86 2 0 2 0 65 286 86 2 0 2 0 66 286 86 2 0 2 0 67 286 86 2 0 2 0 68 286 86 2 0 2 0 69 286 86 2 0 2 0 70 286 86 2 0 2 0 71 286 86 2 0 2 0 72 286 86 2 0 2 0 73 286 86 2 0 2 0 74 286 86 2 0 2 0 75 286 86 2 0 2 0 76 286 86 2 0 2 0 77 286 86 2 0 2 0 78 286 86 2 0 2 0 79 286 86 2 0 2 0 80 286 86 2 0 2 0 81 286 86 2 0 2 0 82 286 86 2 0 2 0 83 286 86 2 0 2 0 84 286 86 2 0 2 0 85 286 86 2 0 2 0 86 286 86 2 0 2 0 87 286 86 2 0 2 0 88 286 86 2 0 2 0 89 286 86 2 0 2 0 90 286 86 2 0 2 0 91 286 86 2 0 2 0 92 286 86 2 0 2 0 93 286 86 2 0 2 0 94 286 86 2 0 2 0 95 286 86 2 0 2 0 96 286 86 2 0 2 0 97 286 86 2 0 2 0 98 286 86 2 0 2 0 99 286 86 2 0 2 0 100 286 86 2 0 2 0 101 286 86 2 0 2 0 102 286 86 2 0 2 0 103 286 86 2 0 2 0 104 286 86 2 0 2 0 105 286 86 2 0 2 0 106 286 86 2 0 2 0 107 286 86 2 0 2 0 108 286 86 2 0 2 0 109 286 86 2 0 2 0 110 286 86 2 0 2 0 111 286 86 2 0 2 0 112 286 86 2 0 2 0 113 286 86 2 0 2 0 114 286 86 2 0 2 0 115 286 86 2 0 2 0 116 286 86 2 0 2 0 117 286 86 2 0 2 0 118 286 86 2 0 2 0 119 286 86 2 0 2 0 120 286 86 2 0 2 0 121 286 86 2 0 2 0 122 286 86 2 0 2 0 123 286 86 2 0 2 0 124 286 86 2 0 2 0 125 286 86 2 0 2 0 126 286 86 2 0 2 0 127 286 86 2 0 2 0 128 286 86 2 0 2 0 129 286 86 2 0 2 0 130 286 86 2 0 2 0 131 286 86 2 0 2 0 132 286 86 2 0 2 0 133 286 86 2 0 2 0 134 286 86 2 0 2 0 135 286 86 2 0 2 0 136 286 86 2 0 2 0 137 286 86 2 0 2 0 138 286 86 2 0 2 0 139 286 86 2 0 2 0 140 286 86 2 0 2 0 141 286 86 2 0 2 0 142 286 86 2 0 2 0 143 286 86 2 0 2 0 144 286 86 2 0 2 0 145 286 86 2 0 2 0 146 286 86 2 0 2 0 147 286 86 2 0 2 0 148 286 86 2 0 2 0 149 286 86 2 0 2 0 150 286 86 2 0 2 0 151 286 86 2 0 2 0 152 286 86 2 0 2 0 153 286 86 2 0 2 0 154 286 86 2 0 2 0 155 286 86 2 0 2 0 156 286 86 2 0 2 0 157 286 86 2 0 2 0 158 286 86 2 0 2 0 159 286 86 2 0 2 0 160 286 86 2 0 2 0 161 286 86 2 0 2 0 162 286 86 2 0 2 0 163 286 86 2 0 2 0 164 286 86 2 0 2 0 165 286 86 2 0 2 0 166 286 86 2 0 2 0 167 286 86 2 0 2 0 168 286 86 2 0 2 0 169 286 86 2 0 2 0 170 286 86 2 0 2 0 171 286 86 2 0 2 0 172 286 86 2 0 2 0 173 286 86 2 0 2 0 174 286 86 2 0 2 0 175 286 86 2 0 2 0 176 286 86 2 0 2 0 177 286 86 2 0 2 0 178 286 86 2 0 2 0 179 286 86 2 0 2 0 180 286 86 2 0 2 0 181 286 86 2 0 2 0 182 286 86 2 0 2 0 183 286 86 2 0 2 0 184 286 86 2 0 2 0 185 286 86 2 0 2 0 186 286 86 2 0 2 0 187 286 86 2 0 2 0 188 286 86 2 0 2 0 189 286 86 2 0 2 0 190 286 86 2 0 2 0 191 286 86 2 0 2 0 192 286 86 2 0 2 0 193 286 86 2 0 2 0 194 286 86 2 0 2 0 195 286 86 2 0 2 0 196 286 86 2 0 2 0 197 286 86 2 0 2 0 198 286 86 2 0 2 0 199 286 86 2 0 2 0 200 286 86 2 0 2 0 201 286 86 2 0 2 0 202 286 86 2 0 2 0 203 286 86 2 0 2 0 204 286 86 2 0 2 0 205 286 86 2 0 2 0 206 286 86 2 0 2 0 207 286 86 2 0 2 0 208 286 86 2 0 2 0 209 286 86 2 0 2 0 210 286 86 2 0 2 0 211 286 86 2 0 2 0 212 286 86 2 0 2 0 213 286 86 2 0 2 0 214 286 86 2 0 2 0 215 286 86 2 0 2 0 216 286 86 2 0 2 0 217 286 86 2 0 2 0 218 286 86 2 0 2 0 219 286 86 2 0 2 0 220 286 86 2 0 2 0 221 286 86 2 0 2 0 [e] [w] 0 8274 86 2 0 1 914 86 2 0 [e] [data] 50 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_rot_pal_raw 50 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@23.00 51 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_contrast_pal_struc 51 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@24.00 52 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_transpose_pal_struc 52 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@24.00 53 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_cpcontrast_pal_struc 53 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@24.00 54 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XLINE 54 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@25.00 55 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 55 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@25.00 56 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 56 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@25.00 57 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 57 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@26.00 58 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_line 58 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@26.00 59 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XTEXT 59 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@27.00 60 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 60 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@27.00 61 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 61 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@27.00 62 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@MACROS 62 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@27.00 63 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED VARIABLES 63 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@27.00 64 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 64 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@28.00 65 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_text_init 65 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@28.00 66 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_set_font 66 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@28.00 67 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_register_userfont 67 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@28.00 68 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_char 68 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@29.00 69 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_printf 69 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@29.00 70 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_bgprintf 70 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@30.00 71 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_get_char_width 71 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@30.00 72 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XPBITMAP 72 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@31.00 73 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 73 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@31.00 74 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 74 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@31.00 75 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 75 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@32.00 76 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_masked_pbm 76 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@32.00 77 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_pbm 77 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@32.00 78 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_get_pbm 78 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@33.00 79 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XPBMCLIP 79 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@34.00 80 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 80 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@34.00 81 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 81 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@34.00 82 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 82 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@34.00 83 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_masked_pbm_clipx 83 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@35.00 84 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_masked_pbm_clipy 84 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@35.00 85 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_masked_pbm_clipxy 85 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@36.00 86 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_pbm_clipx 86 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@36.00 87 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_pbm_clipy 87 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@37.00 88 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_pbm_clipxy 88 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@37.00 89 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XCBITMAP 89 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@38.00 90 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 90 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@38.00 91 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 91 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@38.00 92 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 92 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@39.00 93 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_compile_bitmap 93 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@39.00 94 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_sizeof_cbitmap 94 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@39.00 95 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_cbitmap 95 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@39.00 96 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XCOMPPBM 96 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@40.00 97 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 97 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@40.00 98 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 98 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@40.00 149 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED VARIABLES 149 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@60.00 99 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 99 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@41.00 100 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_compile_pbm 100 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@41.00 101 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_sizeof_cpbm 101 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@41.00 102 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XVBITMAP 102 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@42.00 103 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 103 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@43.00 104 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 104 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@43.00 105 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 105 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@44.00 106 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_make_vbm 106 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@44.00 107 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_masked_vbm 107 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@44.00 108 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_masked_vbm_clipx 108 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@45.00 109 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_masked_vbm_clipy 109 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@45.00 110 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_masked_vbm_clipxy 110 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@46.00 111 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XMOUSE 111 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@47.00 112 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@MS Mouse Driver Functions 112 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@47.00 113 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 113 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@48.00 114 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 114 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@48.00 115 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED VARIABLES 115 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@48.00 116 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 116 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@49.00 117 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_mouse_init 117 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@49.00 118 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_define_mouse_cursor 118 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@49.00 119 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_show_mouse 119 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@50.00 120 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_hide_mouse 120 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@50.00 121 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_mouse_remove 121 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@50.00 122 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_position_mouse 122 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@50.00 123 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_mouse_window 123 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@50.00 124 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_update_mouse 124 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@51.00 125 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XBMTOOLS 125 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@52.00 126 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 126 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@52.00 127 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 127 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@52.00 128 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@MACROS 128 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@53.00 129 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORT FUNCTIONS 129 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@54.00 130 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_pbm_to_bm 130 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@54.00 131 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_bm_to_pbm 131 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@54.00 132 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XCLIPPBM 132 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@55.00 133 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 133 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@55.00 134 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 134 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@55.00 135 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED VARIABLES 135 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@55.00 136 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 136 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@56.00 137 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_clip_pbm 137 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@56.00 138 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_clip_masked_pbm 138 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@56.00 139 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XCIRCLE 139 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@57.00 140 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 140 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@57.00 141 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 141 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@57.00 142 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 142 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@58.00 143 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_circle 143 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@58.00 144 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_filled_circle 144 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@58.00 145 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XDETECT 145 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@59.00 146 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 146 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@59.00 147 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 147 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@59.00 148 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED MACROS 148 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@59.00 150 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 150 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@61.00 151 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_graphics_card 151 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@61.00 152 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_processor 152 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@61.00 153 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_coprocessor 153 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@61.00 154 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_mousedriver 154 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@61.00 155 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XFILEIO 155 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@62.00 156 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 156 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@62.00 157 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 157 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@62.00 158 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED MACROS 158 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@62.00 159 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 159 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@63.00 160 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@f_open 160 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@63.00 161 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@f_close 161 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@63.00 162 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@f_read 162 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@63.00 163 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@f_readfar 163 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@64.00 164 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@f_write 164 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@64.00 165 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@f_writefar 165 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@64.00 166 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@f_seek 166 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@65.00 167 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@f_filelength 167 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@65.00 168 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@f_tell 168 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@65.00 169 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XRLETOOL 169 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@66.00 170 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 170 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@66.00 171 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 171 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@66.00 172 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 172 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@67.00 173 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_buff_RLDecode 173 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@67.00 174 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_buff_RLEncode 174 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@67.00 175 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_buff_RLE_size 175 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@67.00 176 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_file_RLEncode 176 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@68.00 177 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_file_RLDecode 177 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@68.00 178 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XPOLYGON 178 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@69.00 179 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 179 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@69.00 180 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 180 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@69.00 181 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@TYPE DEFS 181 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@69.00 182 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 182 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@70.00 183 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_triangle 183 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@70.00 184 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_polygon 184 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@71.00 185 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XBEZIER 185 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@71.00 186 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 186 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@72.00 187 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 187 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@72.00 188 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 188 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@73.00 189 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_bezier 189 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@73.00 190 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XFILL 190 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@74.00 191 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 191 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@74.00 192 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 192 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@74.00 193 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 193 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@75.00 194 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_flood_fill 194 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG3@<+A>75.00 195 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_boundry_fill 195 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG3@<+A>75.00 196 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XVSYNC 196 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG1@<+A>76.00 197 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 197 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>76.00 198 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 198 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>76.00 199 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED VARIABLES 199 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>77.00 200 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 200 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>78.00 201 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_install_vsync_handler 201 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG3@<+A>78.00 202 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_remove_vsync_handler 202 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG3@<+A>78.00 203 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_set_user_vsync_handler 203 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG3@<+A>78.00 204 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_wait_start_addr 204 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG3@<+A>79.00 205 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XCBITM32 205 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG1@<+A>79.00 206 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 206 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>80.00 207 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 207 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>80.00 208 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 208 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>81.00 209 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_compile_bitmap_32 209 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG3@<+A>81.00 210 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_sizeof_cpbm 210 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG3@<+A>81.00 211 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@REFERENCE SECTION 211 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG1@<+A>82.00 212 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@REFERENCES 212 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>82.00 213 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@WHAT IS MODE X ? 213 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>82.00 214 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@WHAT IS A SPLIT SCREEN ? 214 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>82.00 215 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@WHAT IS RLE? 215 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>83.00 216 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@WHAT IS DOUBLE BUFFERING ? 216 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>84.00 217 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@WHAT IS TRIPLE BUFFERING? 217 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>84.00 218 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@WHAT IS A BEZIER CURVE? 218 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>84.00 219 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@The Care and Feeding of Compiled Masked Blits 219 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>85.00 220 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@Blits and Pieces 220 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>87.00 221 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@Wheel Have to See About That 221 1 16400 0 0 0 0 1 0 0 0 0 @TOCPG2@<+A>88.00 0 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@INTRODUCTION 0 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@1.00 1 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EDITORS NOTE 1 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@1.00 2 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@CONTACTING THE AUTHORS 2 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@1.00 3 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@DISCLAIMER 3 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@1.00 4 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@ABOUT XLIB 4 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@1.00 5 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@GENERAL FEATURES 5 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@2.00 6 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@MODULES COMPRISING XLIB 6 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@2.00 7 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@GLOBAL DEFINES 7 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@3.00 8 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XMAIN 8 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@4.00 9 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 9 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@4.00 10 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 10 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@4.00 11 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED VARIABLES 11 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@4.00 12 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 12 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@7.00 13 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_set_mode 13 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@7.00 14 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_select_default_plane 14 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@7.00 15 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_set_splitscreen 15 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@8.00 16 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_set_doublebuffer 16 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@9.00 17 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_hide_splitscreen 17 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@10.00 18 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_show_splitscreen 18 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@11.00 19 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_adjust_splitscreen 19 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@11.00 20 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_set_start_addr 20 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@11.00 21 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_page_flip 21 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@12.00 22 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_text_mode 22 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@12.00 23 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_set_cliprect 23 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@12.00 24 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XPOINT 24 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@13.00 25 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 25 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@13.00 26 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 26 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@13.00 27 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 27 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@14.00 28 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_pix 28 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@14.00 29 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_get_pix 29 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@14.00 30 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XRECT 30 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@15.00 31 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 31 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@15.00 32 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 32 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@15.00 33 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 33 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@16.00 34 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_rect_pattern 34 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@16.00 35 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_rect_pattern_clipped 35 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@17.00 36 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_rect_fill 36 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@17.00 37 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_rect_fill_clipped 37 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@18.00 38 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_cp_vid_rect 38 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@19.00 39 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_shift_rect 39 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@20.00 40 0 16384 0 0 0 0 1 0 0 0 0 @TOC1@MODULE XPAL 40 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG1@21.00 41 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@SOURCES 41 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@21.00 42 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@C HEADER FILE 42 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@21.00 43 0 16384 0 0 0 0 1 0 0 0 0 @TOC2@EXPORTED FUNCTIONS 43 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG2@22.00 44 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_get_pal_raw 44 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@22.00 45 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_get_pal_struc 45 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@22.00 46 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_pal_raw 46 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@22.00 47 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_put_pal_struc 47 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@23.00 48 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_set_rgb 48 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@23.00 49 0 16384 0 0 0 0 1 0 0 0 0 @TOC3@x_rot_pal_struc 49 1 16384 0 0 0 0 1 0 0 0 0 @TOCPG3@23.00 [e] [tble] [lay] Standard [rght] 15840 12240 1440 1440 1440 1440 1440 10800 720 1440 2160 2880 3600 4320 5040 5760 6480 7200 7920 8640 [hrght] [lyfrm] 11200 12240 1440 1 0 0 0 0 0 0 [frmlay] 1440 12240 1440 792 1440 1440 10800 4680 9360 [txt] <+A><:s> <+A><:P12,1,> [frght] [lyfrm] 13248 14400 12240 15840 1 0 0 0 0 0 0 [frmlay] 15840 12240 1440 792 14472 1440 1440 10800 4680 9360 [txt] [elay] [lay] [rght] 15840 12240 1440 1440 1440 1440 1440 10800 720 1440 2160 2880 3600 4320 5040 5760 6480 7200 7920 8640 [hrght] [lyfrm] 11200 12240 1440 1 0 0 0 0 0 0 [frmlay] 1440 12240 1440 792 1440 1440 10800 4680 9360 [txt] [frght] [lyfrm] 13248 14400 12240 15840 1 0 0 0 0 0 0 [frmlay] 15840 12240 1440 792 14472 1440 1440 10800 4680 9360 [txt] [elay] 1 0 5 16384 0 0 0 65535 65535 1 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 34 0 0 1 0 5 16384 0 0 0 65535 65535 1 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 34 34 0 0 1 0 5 16384 0 0 0 65535 65535 1 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 68 34 0 0 1 0 5 16384 0 0 0 65535 65535 1 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 102 34 0 0 1 0 5 16384 0 0 0 65535 65535 1 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 136 34 0 0 1 0 5 16384 0 0 0 65535 65535 1 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 170 34 0 0 1 5 5 17920 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 44 0 0 0 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 77 0 0 0 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 122 0 47 0 0 1 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 160 0 33 512 0 1 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 199 94 28 0 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 225 0 0 0 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 247 0 98 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 276 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 294 0 76 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 331 0 9 512 3 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 341 0 44 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 373 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 400 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 417 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 443 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 459 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 481 0 55 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 520 0 55 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 540 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 567 0 55 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 585 0 92 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 610 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 652 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 694 0 71 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 727 96 31 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 744 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 765 0 34 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 806 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 843 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 876 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 900 0 52 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 926 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 966 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 987 0 85 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1017 0 7 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1057 0 38 512 3 0 0 65535 6 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1094 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1131 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1144 0 16 512 0 1 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1185 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1198 0 19 512 0 1 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1225 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1255 566 88 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1269 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1296 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1326 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1343 0 95 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1375 91 75 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1405 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1435 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1475 0 82 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1482 93 13 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1517 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1533 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1568 0 21 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1594 0 26 512 0 1 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1623 87 14 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1637 0 15 512 0 1 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1669 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1708 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1720 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1757 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1787 0 15 512 0 1 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1826 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1870 0 0 0 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1898 0 75 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1914 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1958 0 0 0 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 1984 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2001 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2023 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2040 197 12 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2051 0 19 512 0 1 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2076 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2086 0 13 512 0 1 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2121 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2150 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2158 0 21 512 0 1 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2198 197 42 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2210 0 37 512 0 1 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2221 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2247 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2277 188 84 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2307 0 5 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2322 0 7 512 1 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2357 0 20 0 0 1 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2380 0 45 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2402 287 58 512 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 2412 0 0 1025 0 0 0 65535 65535 Standard 65535 0 0 0 0 0 0 0 0 0 65535 0 0 65535 0 0 0 0 0 [edoc] <:s><:t0><:p</B>Standard> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <+B><:s><:#733,9360><:f720,BFinal Frontier,0,0,0> <+!>XLIB<:f> <+B><:s><:#367,9360><:f360,BFinal Frontier,0,0,0><+!>The "Mode X" graphics library.<-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <+B><:s><:#286,9360>Written by: Themie Gouthas. <+B><:s><:#286,9360>Additional code contributed by: Matthew MacKenzie and Tore Jahn Bastiansen. <+B><:s><:#286,9360>Manual edited by: J. Donavan Stanley. <:s><:#286,9360> <:s><:#286,9360> <+B><:#333,9360><+!><:f280, Times New Roman,0,0,0>INTRODUCTION<:f><-!><:X11,-32768;TOC 1 "INTRODUCTION"> <+@><:s><:#286,9360> <+@><:#286,9360><+!>EDITORS NOTE<:X11,-32768;TOC 2 "EDITORS NOTE">:<-!> <:s><:#286,9360> <:#1430,9360>"Do not trust this excuse for a manual when in doubt go to the code." Those words were written by Themie Gouthas in each manual accompanying an XLIB release. I have undertaken this project to provide you the end user with a high-quality, <+#>accurate<-#> manual to use. I have gone to the code, checked and cross-checked everything and consulted the authors to ensure everything is correct. Just the same I'm only human, so if you spot any errors please let me know. <:s><:#286,9360> <:#1430,9360>Throughout this manual function names are in bold italics, variables are in regular italics. This only holds true for those of you who are reading the non-ASCII version of this document. If your favorite word processor isn't included in this release of th e manual let me know and I will make very effort to support it. I also plan on making a printed, 3-ring bound versions available for a small fee (Enough to cover the cost of materials and postage) if enough people are interested. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "CONTACTING THE AUTHORS">CONTACTING THE AUTHORS<-!><+!>:<-!> <:s><:#286,9360> Themie Gouthas - Internet: egg@dstos3.dsto.goc.au or teg@bart.dsto.gov.au <:s><:#286,9360> Matthew MacKenzie - Internet: matm@eng.umd.edu <:s><:#286,9360> Tore Bastiansen - Internet: toreba@ifi.uio.no <:s><:#286,9360> Donavan Stanley (The editor) - Internet: bbooth@vax.cns.muskingnum.edu (This is a <:s><:#286,9360> friend who will relay your message to me.) <:s><:#286,9360> BBS: The Last Byte BBS (614) 432-3564. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>DISCLAIMER<:X11,-32768;TOC 2 "DISCLAIMER"><-!> <:s><:#286,9360><+!> <:s><:#865,9360><+!>This library is distributed AS IS.<-!> The authors specifically disclaim any responsibility for any loss of profit or any incidental, consequential or other damages. The authors reserve ALL rights to the code contained in XLIB. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>ABOUT XLIB<:X11,-32768;TOC 2 "ABOUT XLIB"><-!> <:s><:#286,9360> <:s><:#865,9360>XLIB is a "user supported freeware" graphics library specifically designed with game programming in mind. It has been released to the public for the benefit of all and is the result of <+!>MANY<-!> hours of or work. <:s><:#286,9360> <:s><:#293,9360>All users <+!>must <-!>comply with the following guidelines: @Number List@<:s><:#286,9360>Leave the code in the public domain. @Number List@<:s><:#286,9360>Do not distribute any modified or incomplete versions of this library. <:s><:#286,9360> <:s><:#286,9360>New contributions and comments are welcome. There will be more releases as the code evolves. <:s><:#286,9360> <:#286,9360><+!>GENERAL FEATURES<:X11,-32768;TOC 2 "GENERAL FEATURES"><-!> <:s><:#286,9360> @Bullet 1@<:s><:#286,9360> Support for a number of 256 color tweaked graphics mode resolutions <:s><:#286,9360> 320x200 320x240 360x200 360x240 376x282 320x400 320x480 360x400 360x480 <:s><:#286,9360> 360x360 376x308 376x564 <:s><:#286,9360> @Bullet 1@<:s><:#286,9360> Virtual screens larger than the physical screen (memory permitting) that can be panned at <:s><:#286,9360> pixel resolution in all directions <:s><:#286,9360> @Bullet 1@<:s><:#286,9360> A split screen capability for status displays etc. <:s><:#286,9360> @Bullet 1@<:s><:#286,9360> Text functions supporting 8x8 and 8x14 ROM fonts and user defined fonts <:s><:#286,9360> @Bullet 1@<:s><:#286,9360> Support for page flipping <:s><:#286,9360> @Bullet 1@<:s><:#286,9360> Graphics primitives such as line and rectangle drawing functions. <:s><:#286,9360> @Bullet 1@<:s><:#286,9360> Bit block manipulation functions <:s><:#286,9360> <:s><:#286,9360><:f240, Times New Roman,0,0,0> @Bullet@<:s><:#286,9360><:f240, Times New Roman,0,0,0>Please note that some of the resolutions best suit monitors with adjustable vertical height.<:f> <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>MODULES COMPRISING XLIB<:X11,-32768;TOC 2 "MODULES COMPRISING XLIB"> <:s><:#286,9360> <:s><:#286,9360> XMAIN Main module containing mode setting code and basic functions <:s><:#286,9360> XPOINT Pixel functions <:s><:#286,9360> XRECT Filled rectangle and VRAM to VRAM block move functions <:s><:#286,9360> XPAL Palette functions <:s><:#286,9360> XLINE Line functions <:s><:#286,9360> XTEXT Text and font functions <:s><:#286,9360> XPRINTF Printf style string output <:s><:#286,9360> XPBITMAP Planar bitmap functions <:s><:#286,9360> XPBMCLIP Clipped planar bitmap functions <:s><:#286,9360> XCBITMAP Compiled bitmap functions using linear bitmaps. <:s><:#286,9360> XCOMPPBM Compiled bitmap functions using planar bitmaps. <:s><:#286,9360> XVBITMAP Video bitmap functions <:s><:#286,9360> XMAKEVBM Support module for video bitmaps <:s><:#286,9360> XMOUSE Mouse functions <:s><:#286,9360> XBMTOOLS Bitmap format conversion tools <:s><:#286,9360> XCLIPPBM Clipped planar bitmap functions. (Uses blits.) <:s><:#286,9360> XCIRCLE Circle Drawing functions. <:s><:#286,9360> XDETECT Hardware detection module <:s><:#286,9360> XFILEIO File I/O functions <:s><:#286,9360> XRLETOOL RLE encoding/decoding functions <+@><:s><:#286,9360> XPOLYGON Convex polygon and triangle functions. <+@><:s><:#286,9360> XBEZIER Bezier curve drawing <+@><:s><:#286,9360> XFILL General purpose flood fill routines. <+@><:#286,9360> XVSYNC Simulated vertical retrace Interrupt module. <+@><:#286,9360> XCBITM32 32 Bit compiled bitmaps. <+B><:s><:#286,9360> <+B><:s><:#286,9360> <+@><:#286,9360><:f240, Times New Roman,0,0,0><+!>GLOBAL DEFINES<:X11,-32768;TOC 2 "GLOBAL DEFINES"> (xlib.inc)<-!><:f> <+B><:s><:#333,9360><+!><:f280,2Times New Roman,0,0,0> <:s><:#286,9360><+!> Types: <:s><:#286,9360> BYTE unsigned char <:s><:#286,9360> WORD unsigned int <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360><+!> Available X mode resolutions:<-!> <:s><:#286,9360> X_MODE_320x200 0 <:s><:#286,9360> X_MODE_320x240 1 <:s><:#286,9360> X_MODE_360x200 2 <:s><:#286,9360> X_MODE_360x240 3 <:s><:#286,9360> X_MODE_360x282 4 <:s><:#286,9360> X_MODE_320x400 5 <:s><:#286,9360> X_MODE_320x480 6 <:s><:#286,9360> X_MODE_360x400 7 <:s><:#286,9360> X_MODE_360x480 8 <:s><:#286,9360> X_MODE_360x360 9 <:s><:#286,9360> X_MODE_376x308 10 <:s><:#286,9360> X_MODE_376x564 11 <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360><+!> Palette rotation direction<-!><+!>:<-!> <:s><:#286,9360> BACKWARD 0 <:s><:#286,9360> FORWARD 1 <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360><+!> Function return values:<-!> <:s><:#286,9360> X_MODE_INVALID -1 <:s><:#286,9360> ERROR 1 <:s> OK 0<:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XMAIN<:X11,-32768;TOC 1 "MODULE XMAIN"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:s><:#572,9360>The Xmain module is the base module of the XLIB library. It contains the essential functions that initialize and customize the graphic environment. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:f,,>SOURCES<:X11,-32768;TOC 2 "SOURCES"><-!> <:s><:#286,9360> xmain.asm <:s><:#286,9360> xmain.inc <:s><:#286,9360> xlib.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>C HEADER FILE<:X11,-32768;TOC 2 "C HEADER FILE"><-!> <:s><:#286,9360> xlib.h <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>EXPORTED VARIABLES<:X11,-32768;TOC 2 "EXPORTED VARIABLES"><-!> <:s><:#286,9360> <:s><:#579,9360><+!>NOTE: <-!>All variables are read only unless otherwise specified. <+#>If you modify them manually, the results may be unpredictable<-#>. <:s><:#286,9360> <:s><:#293,9360><+">InGraphics<-"> BYTE- Flag indicating that the xlib graphics system is active. Set by function <:s><:#293,9360><+!><+">x_set_mode<-"><-!>. <:s><:#286,9360> <:s><:#586,9360><+">CurrXMode<-"> WORD - If the xlib graphics system is active, contains the id of the x mode. Set by function <+!><+">x_set_mode<-"><-!>. <+"> <-">See also: defines (i.e. X_MODE_320x200 ... ) <:s><:#286,9360> <:s><:#293,9360><+">ScrnPhysicalByteWidth<-"> WORD - Physical screen width in bytes. Set by function <+!><+">x_set_mode<-"><-!> <:s><:#286,9360> <:s><:#293,9360><+">ScrnPhysicalPixelWidth<-"> WORD - Physical screen width in pixels. Set by function <+!><+">x_set_mode<-"><-!> <:s><:#286,9360><+!> <:s><:#293,9360><+">ScrnPhysicalHeight<-"> WORD - Physical screen height in pixels. Set by function <+!><+">x_set_mode<-"><-!>. <:s><:#286,9360> <:s><:#293,9360><+">ScrnLogicalByteWidth<-"> WORD - Virtual screen width in bytes. Set by function <+!><+">x_set_mode<-"><-!>. <:s><:#286,9360> <:s><:#293,9360><+">ScrnLogicalPixelWidth<-"> WORD - Virtual screen width in pixels. Set by function <+!><+">x_set_mode<-"><-!>. <:s><:#286,9360> <:s><:#586,9360><+">ScrnLogicalHeight<-"> WORD - Virtual screen height in pixels. Set initially by function <+!><+">x_set_mode<-"><-!> but is updated by functions <+!><+">x_set_splitscrn<-"><-!> and <+!><+">x_set_doublebuffer<-"><-!>. <:s><:#286,9360> <:s><:#586,9360><+">MaxScrollX<-"> WORD - Max. X pixel position of physical screen within virtual screen. Set by function <+!><+">x_set_mode<-"><-!>. <:s><:#586,9360><+">MaxScrollY<-"> WORD - Max. Y pixel position of physical screen within virtual screen. Set initially by function <+!><+">x_set_mode<-"><-!> but is updated by functions <+!><+">x_set_splitscrn<-"><-!> and <+!><+">x_set_doublebuffer<-"><-!>. <:s><:#293,9360><+"> <:s><:#865,9360><+">ErrorValue<-"> WORD - Contains error value. General use variable to communicate the error status from several functions. The value in this variable usually is only valid for the last function called that sets it. <:s><:#286,9360> <:s><:#586,9360><+">SplitScrnOffs<-"> WORD - Offset in video ram of split screen. Set by function <+!><+">x_set_splitscrn<-"><-!>. The value is only valid if a split screen is active. See also: global variable <+">SplitScrnActive<-">. <:s><:#286,9360> <:s><:#879,9360><+">SplitScrnScanLine<-"> WORD - Screen Scan Line the Split Screen starts at initially when set by function<+!><+"> x_set_splitscrn<-"><-!>. <+#>The value is only valid if a split screen is active<-#>. See also: global variable<+"> SplitScrnActive<-">. This variable is not updated by <+!><+">x_hide_splitscrn<-"><-!> or <+!><+">x_adjust_splitscrn<-"><-!>. <:s><:#286,9360> <:s><:#586,9360><+">SplitScrnVisibleHeight<-"> WORD - The number of rows of the initial split screen which are currently displayed. Modified by <+!><+">x_hide_splitscrn<-"><-!>, <+!><+">x_adjust_splitscrn<-"><-!> and <+!><+">x_show_splitscrn<-"><-!>. <:s><:#286,9360> <:s><:#586,9360><+">Page0_Offs<-"> WORD - Offset in video ram of main virtual screen. Initially set by function <+!><+">x_set_mode<-"><-!> but is updated by functions <+!><+">x_set_splitscrn<-"><-!> and <+!><+">x_set_doublebuffer<-"><-!>. <:s><:#286,9360> <:s><:#586,9360><+">Page1_Offs<-"> WORD - Offset in video ram of second virtual screen. Set by and only is valid after a call to <+!><+">x_set_doublebuffer <-"><-!> or <+!><+">x_triple_buffer.<-"><-!> <:s><:#286,9360> <:s><:#586,9360><+">Page2_Offs<-"> WORD - Offset in video ram of the third virtual screen. Set by and is only valid after a call to <+!><+">x_triple_buffer.<-"><-!> <:s><:#286,9360><+!><+"> <:s><:#872,9360><+">WaitingPageOffs<-"> WORD - Offset in video ram of the page waiting to be invisible. Initially set by <+!><+">x_triple_buffer <-!><-">but is updated by <+!><+">x_page_flip<-!><-">. This variable is only used while triple buffering is active.<-"><-"> <:s><:#286,9360> <:s><:#586,9360><+">HiddenPageOffs<-"> WORD - Offset of hidden page. Initially set by function <+!><+">x_set_doublebuffer<-"><-!> but is updated by <+!><+">x_page_flip<-"><-!>. <+#>This variable is only used while double (or triple ) buffering is on<-#>. <:s><:#286,9360> <:s><:#586,9360><+">VisiblePageOffs<-"> WORD - Offset of visible page. Initially set by function <+!><+">x_set_doublebuffer<-"><-!> but is updated by <+!><+">x_page_flip<-"><-!>. <+#>This variable is only used while double (or triple) buffering is on<-#>. <:s><:#286,9360> <:s><:#879,9360><+">NonVisual_Offs<-"> WORD - Offset of first byte of non-visual ram, the ram that is available for bitmap storage etc. Set initially by function <+!><+">x_set_mode<-"><-!> but is updated by functions <+!><+">x_set_splitscrn<-"><-!> and <+!><+">x_set_doublebuffer<-"><-!>. <:s><:#286,9360> <:s><:#872,9360><+">VisiblePageIdx<-"> WORD - Index number of current visible page. Initially set by function <+!><+">x_set_doublebuffer<-"><-!> but is updated by <+!><+">x_page_flip<-"><-!>. <+#>This variable is only used while double( or triple) buffering is on<-#>. <:s><:#286,9360> <:s><:#586,9360><+">DoubleBufferActive<-"> WORD - Indicates whether double-buffering is on. Set by function <+!><+">x_set_doublebuffer<-"><-!>. <:s><:#286,9360> <:s><:#579,9360><+">TripleBufferActive<-"> WORD - Indicates whether triple-buffering is active. Set by function <+!><+">x_triple_buffer.<-"><-!> <:s><:#286,9360><+!><+"> <:s><:#586,9360><+">TopClip, BottomClip, LeftClip RightClip<-"> WORD - Defines the clipping rectangle for linear and Video clipped bitmap put functions. Set either manually or by <+!><+">x_set_cliprect. <-"><-!> <:s><:#293,9360><+!>Note:<-!> <+#>X coordinates are in bytes as all clip functions clip to byte boundaries<-#>. <:s><:#286,9360> <:s><:#579,9360><+">PhysicalStartPixelX<-"> WORD - X pixel Offset of physical (visible) screen relative to the upper left hand corner (0,0) of the virtual screen. <:s><:#286,9360> <:s><:#579,9360><+">PhysicalStartByteX<-"> WORD - X byte Offset of physical (visible) screen relative to the upper left hand corner (0,0) of the virtual screen. <:s><:#286,9360> <:s><:#579,9360><+">PhysicalStartY<-"> WORD - Y pixel Offset of physical (visible) screen relative to the upper left hand corner (0,0) of the virtual screen. <:s><:#286,9360> <:s><:#579,9360><+">StartAddressFlag<-"> WORD - This flag is set if there is a new start address waiting to be set by the vsync handler. <:s><:#286,9360> <:s><:#586,9360><+">WaitingStartLow, WaitingStartHigh, WaitingPelPan<-"> WORD - These are used by the vsync handler <+#>only<-#>. <+!>Do not modify! <:s><:#286,9360><+!> <:s><:#579,9360><+">VsyncPaletteCount <-">WORD - The start index of the video DAC register to be updated during the next vsync. Set by the palette functions. <:s><:#286,9360> <:#579,9360><+">VsyncPaletteCount<-"> WORD - The number of palette entries to be outed during the next vsync. Set by the palette functions. <:s><:#286,9360> <:s><+">VsyncPaletteBuffer <-">BYTE<[>768] - A buffer containing values for the next update of the DAC.<:p<* >> <+@><:#286,9360><:f240, Times New Roman,0,0,0><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!><:f> <+B><:s><:#333,9360><+!><:f280,2Times New Roman,0,0,0> <+B><:s><:#333,9360><+!><:f280,2Times New Roman,0,0,0> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_set_mode<:X11,-32768;TOC 3 "x_set_mode"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern WORD x_set_mode(WORD mode, WORD WidthInPixels); <:s><:#286,9360> <:s><:#579,9360><+">mode <-">- The required mode as defined by the "Available X Mode resolutions" set of defines in the xlib.h header file. <:s><:#286,9360> <:s><:#293,9360><+">WidthInPixels<-"> - The required virtual screen width. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The actual width in pixels of the allocated virtual screen <:s><:#286,9360> <:s><:#865,9360>This function initializes the graphics system, setting the appropriate screen resolution and allocating a virtual screen. The virtual screen allocated may not necessarily be of the same size as specified in the <+">WidthInPixels<-"> parameter as it is rounded down to the nearest multiple of 4. <:s><:#286,9360> <:s><:#572,9360>The function returns the actual width of the allocated virtual screen in pixels if a valid mode was selected otherwise returns X_MODE_INVALID. <:s><:#286,9360> <:s><:#1172,9360>Saves virtual screen pixel width in <+">ScrnLogicalPixelWidth<-">. Saves virtual screen byte width in <+">ScrnLogicalByteWidth<-">. Physical screen dimensions are set in <+">ScrnPhysicalPixelWidth<-">. <+">ScrnPhysicalByteWidth<-"> and <+">ScrnPhysicalHeight<-">. Other global variables set are <+">CurrXMode<-">, <+">MaxScrollX<-">, <+">MaxScrollY<-">, <+">InGraphics<-">. The variable <+">SplitScrnScanLine<-"> is also initialized to zero. <:s><:#286,9360> <:s><:#293,9360><+!>See also:<-!> "Available X Mode resolutions." and "What is Mode X?" <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_select_default_plane<:X11,-32768;TOC 3 "x_select_default_plane"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype<-!>: void x_select_default_plane(BYTE plane); <:s><:#286,9360> <:s><:#293,9360><+">plane<-"> - The plane number you wish to work with. <:s><:#286,9360> <:s><:#286,9360>Enables default Read/Write access to a specified plane <:s><:#286,9360> <:s><:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_set_splitscreen<:X11,-32768;TOC 3 "x_set_splitscreen"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_set_splitscreen(WORD line); <:s><:#286,9360> <:s><:#293,9360><+">line<-"> - The starting scan line of the required split screen. <:s><:#286,9360> <:s><:#572,9360>This function activates Mode X split screen and sets starting scan line. The split screen resides on the bottom half of the screen and has a starting address of A000:0000 in video RAM. <:s><:#286,9360> <:s><:#1172,9360>It also updates <+">Page0_Offs<-"> to reflect the existence of the split screen region <+">MainScrnOffset<-"> is set to the offset of the first pixel beyond the split screen region. Other variable set are <+">Page1_Offs<-"> which is set to the same value as <+">Page0_Offs<-"> (See call sequence below), <+">ScrnLogicalHeight<-">, <+">ScrnPhysicalHeight<-">, <+">SplitScrnScanLine<-"> and <+">MaxScrollY<-">. <:s><:#286,9360> <:s><:#858,9360>This function cannot be called after double buffering has been activated, it will return an error. To configure your graphics environment the sequence of graphics calls is as follows although either or both steps b and c may be omitted: <:s><:#293,9360> a) <+!><+">x_set_mode <-"><-!> <:s><:#293,9360> b) <+!><+">x_set_splitscreen <-"><-!> <:s><:#293,9360> c) <+!><+">x_set_doublebuffer <-"><-!> <:s><:#586,9360>Thus when you call this function successfully, double buffering is not active so <+">Page1_Offs<-"> is set to the same address as <+">Page0_Offs<-">. <:s><:#286,9360> <:s><:#865,9360><+!>WARNING:<-!> If you use one of the high resolution modes (376x564 as an extreme example) you may not have enough video ram for split screen and double buffering options since VGA video RAM is restricted to 64K. <:s><:#286,9360> <:s><+!>See Also:<-!> "What is a Split Screen?" and "What is double buffering?"<:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_set_doublebuffer<:X11,-32768;TOC 3 "x_set_doublebuffer"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern WORD x_set_doublebuffer(WORD PageHeight); <:s><:#286,9360> <:s><:#293,9360><+">PageHeight<-"> - The height of the two double buffering virtual screens. <:s><:#286,9360> <:s><:#293,9360><-!><+!>Returns:<-!> The closest possible height to the requested page height. <:s><:#286,9360> <:s><:#579,9360>This function sets up two double buffering virtual pages. <+">ErrorValue<-"> is set according to the success or failure of this command. <:s><:#286,9360> <:s><:#286,9360>Other variables set are: <:s><:#293,9360> <+">Page1_Offs<-"> - Offset of second virtual page <:s><:#286,9360> <:s><:#293,9360> <+">NonVisual_Offs<-"> - Offset of first non visible video ram byte <:s><:#286,9360> <:s><:#293,9360> <+">DoubleBufferActive<-"> - Flag <:s><:#286,9360> <:s><:#293,9360> <+">PageAddrTable<-"> - Table of Double buffering pages start offsets <:s><:#286,9360> <:s><:#293,9360> <+">ScrnLogicalHeight<-"><+"> <-">- Logical height of the double buffering pages <:s><:#286,9360> <:s><:#293,9360> <+">MaxScrollY<-"> - Max. vertical start address of physical screen within the virtual screen <:s><:#286,9360> <:s><:#865,9360><+!>WARNING<-!>: If you use one of the high resolution modes (376x564 as an extreme example) you may not have enough video ram for split screen and double buffering options since VGA video RAM is restricted to 64K. <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> "What is double buffering?" <:s><:#286,9360> <:s><:#286,9360> <:s><:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_triple_buffer <:s><:#293,9360><+!>C Prototype: <-!>void x_triple_buffer( WORD PageHeight ); <:s><:#286,9360> <:s><:#293,9360><+">PageHeight<-"> - The desired height of the virtual screen. <:s><:#286,9360> <:#1172,9360>This function behaves like <+!><+">x_double_buffer<-!><-"> but when used with <+!><+">x_install_vsync_handler<-!><-"> you can draw immediately after a page flip. When <+!><+">x_page_flip<-!><-"> is called, <+">VisiblePageOffs<-"> is set to the page that will be displayed during the next vysnc. Until then, <+">WaitingPageOffs <-">will be displayed. You can draw to <+">HiddenPageOffs<-">.<-"> <:s><:#286,9360> <:s><:#293,9360><+!>See also: <-!>"What is triple buffering?" <:s><:#286,9360> <:s><+!><+"><:p<* >> <:#326,9360><-"><-"><+!><+"><:f280, Times New Roman,0,0,0><:X11,-32768;TOC 3 "x_hide_splitscreen">x_hide_splitscreen<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_hide_splitscreen(void); <:s><:#286,9360> <:s><:#865,9360>This function hides an existing split screen by setting its starting scan line to the last physical screen scan line. <+">ScreenPhysicalHeight<-"> is adjusted but the <+">SplitScreenScanLine<-"> is not altered as it is required for restoring the split screen at a later stage. <:s><:#286,9360> <:s><:#293,9360><+!>WARNING<-!>: <+#>Only to be used if SplitScrnLine has been previously called<-#> <:s><:#286,9360> <:s><:#858,9360>Disabled for modes 5-11 (320x400-376x564). The memory for the initial split screen is reserved and the size limitations of these modes means any change in the split screen scan line will encroach on the split screen ram <:s><:#286,9360> <:s><+!>See Also:<-!> "What is a split screen?"<:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_show_splitscreen<:X11,-32768;TOC 3 "x_show_splitscreen"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_show_splitscreen(void); <:s><:#286,9360> <:s><:#579,9360>Restores split screen start scan line to the initial split screen starting scan line as set by <+">SplitScrnScanLine<-">. <+">ScreenPhysicalHeight<-"> is adjusted. <:s><:#286,9360> <:s><:#293,9360><+!>WARNING: <-!><+#> Only to be used if SplitScrnLine has been previously called.<-#> <:s><:#286,9360> <:s><:#858,9360>Disabled for modes 5-11 (320x400-376x564). The memory for the initial split screen is reserved and the size limitations of these modes means any change in the split screen scan line will encroach on the split screen ram <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_adjust_splitscreen">x_adjust_splitscreen<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_adjust_splitscreen(WORD line); <:s><:#286,9360> <:s><:#293,9360><+">line <-">- The scan line at which the split screen is to start. <:s><:#286,9360> <:s><:#865,9360>Sets the split screen start scan line to a new scan line. Valid scan lines are between the initial split screen starting scan line and the last physical screen scan line. <+">ScreenPhysicalHeight<-"> is also adjusted. <:s><:#286,9360> <:s><:#293,9360><+!>WARNING:<-!> <+#>Only to be used if SplitScrnLine has been previously called.<-#> <:s><:#286,9360> <:s><:#858,9360>Disabled for modes 5-11 (320x400-376x564). The memory for the initial split screen is reserved and the size limitations of these modes means any change in the split screen scan line will encroach on the split screen ram <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_set_start_addr<:X11,-32768;TOC 3 "x_set_start_addr"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_set_start_addr(WORD X,WORD Y); <:s><:#286,9360> <:s><:#293,9360><+">X, Y<-"><+!> <-!>- coordinates of top left corner of physical screen within current virtual screen. <:s><:#286,9360> <:s><:#286,9360>Set Mode X non split screen physical start address within current virtual page. <:s><:#286,9360><+#> <:#586,9360><+!>WARNING: <-!>X must not exceed (Logical screen width - Physical screen width) i.e. <+">MaxScrollX,<-"> and <+">Y<-"> must not exceed (Logical screen height - Physical screen height) i.e. <+">MaxScrollY<-">. <:s><:#286,9360> <:s><:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_page_flip">x_page_flip<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_page_flip(WORD X,WORD Y); <:s><:#286,9360> <:#579,9360><+">X,Y <-">- coordinates of top left corner of physical screen within the hidden virtual screen if double buffering is active, or the current virtual screen otherwise. <:s><:#286,9360> <:s><:#579,9360>Sets the physical screen start address within currently hidden virtual page and then flips pages. If double buffering is not active then this function is functionally equivalent to <+!><+">x_set_start_addr<-"><-!>. <:s><:#286,9360> <:#586,9360><+!>WARNING: <-!><+">X<-"> must not exceed (Logical screen width - Physical screen width) i.e. <+">MaxScrollX<-">, and <+">Y<-"> must not exceed (Logical screen height - Physical screen height) i.e. <+">MaxScrollY<-">. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_text_mode<:X11,-32768;TOC 3 "x_text_mode"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_text_mode(void); <:s><:#286,9360> <:s><:#286,9360>Disables graphics mode. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_set_cliprect<:X11,-32768;TOC 3 "x_set_cliprect"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_set_cliprect(WORD left,WORD top,WORD right, WORD bottom); <:s><:#286,9360> <:#293,9360><+">left, top<-"> - X and Y coordinates of the upper left corner of the clipping area. <:s><:#286,9360> <:s><:#293,9360><+">right, bottom<-"> - X and Y coordinates of the lower right corner of the clipping area. <:s><:#286,9360> <:s><:#286,9360>Defines the clipping rectangle for clipping versions of planar and video bitmap puts. <:s><:#286,9360> <:s><:#293,9360><+!>NOTE: <-!>Compiled bitmaps cannot be clipped. <:s><:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XPOINT<:X11,-32768;TOC 1 "MODULE XPOINT"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360>Point functions all MODE X 256 Color resolutions <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "SOURCES">SOURCES<-!> <:s><:#286,9360> xpoint.asm <:s><:#286,9360> xpoint.inc <:s><:#286,9360> xlib.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>C HEADER FILE<:X11,-32768;TOC 2 "C HEADER FILE"><-!> <:s><:#286,9360> xpoint.h <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_put_pix<:X11,-32768;TOC 3 "x_put_pix"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_put_pix(WORD X,WORD Y,WORD PageOffset, WORD Color); <:s><:#286,9360> <:s><:#293,9360><+">X, Y<-"> - Coordinates to draw the pixel at. <:s><:#286,9360> <:s><:#293,9360><+">PageOffset<-"> - Virtual page offset to draw on. <:s><:#286,9360> <:s><:#293,9360><+">Color<-"><+!> <-!>- The color to use. <:s><:#286,9360> <:s><:#286,9360>Draw a point of specified color. <:s><:#293,9360><+"> <:s><:#293,9360><+"> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_get_pix">x_get_pix<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern WORD x_get_pix(WORD X, WORD Y, WORD PageBase); <:s><:#286,9360> <:s><:#293,9360><+">X, Y<-"> - Coordinates of the pixel to get. <:s><:#286,9360> <:s><:#293,9360><+">PageOffset<-"> - Virtual page offset the pixel is located on. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The color value of the pixel. <:s><:#286,9360> <:s><:#293,9360>Read a pixel from the given coordinates<+"> <-">within the given virtual page. <:s><:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XRECT<:X11,-32768;TOC 1 "MODULE XRECT"><-!><:f> <:s><:#286,9360> <:s><:#286,9360>Screen rectangle display and manipulation functions <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>SOURCES<:X11,-32768;TOC 2 "SOURCES"><-!> <:s><:#286,9360> xrect.asm <:s><:#286,9360> xrect.inc <:s><:#286,9360> xlib.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:s><:#286,9360> xrect.h <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_rect_pattern">x_rect_pattern<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_rect_pattern(WORD StartX, WORD StartY, WORD EndX, <:s><:#286,9360> WORD EndY, WORD PageBase,BYTE far *Pattern); <:s><:#286,9360> <:s><:#293,9360><+">StartX, StartY<-"> - Coordinates of upper left hand corner of the rectangle. <:s><:#286,9360> <:s><:#293,9360><+">EndX, EndY<-"> - Coordinates of lower right hand corner of the rectangle. <:s><:#286,9360> <:s><:#293,9360><+">PageBase<-"> - Offset of the virtual screen. <:s><:#286,9360> <:#293,9360><+">Pattern<-"> - Pointer to the user defined pattern (16 bytes). <:s><:#286,9360> <:s><:#286,9360>Mode X rectangle 4x4 pattern fill routine. <:s><:#286,9360> <:s><:#1151,9360>Upper left corner of pattern is always aligned to a multiple of 4 row and column. Works on all VGAs. Uses approach of copying the pattern to off-screen display memory, then loading the latches with the pattern for each scan line and filling each scan line f our pixels at a time. Fills up to but not including the column at <+">EndX<-"> and the row at <+">EndY<-">. <+#>No clipping is performed<-#>. <:s><:#286,9360> <:s><:#579,9360><+!>WARNING:<-!> The VGA memory locations PATTERN_BUFFER (A000:FFFc) to A000:FFFF are reserved for the pattern buffer <:s><:#286,9360> <:s><+!>See Also:<-!> <+#>Doctor Dobbs Journal<-#> references.<:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+"><+!><:X11,-32768;TOC 3 "x_rect_pattern_clipped">x_rect_pattern_clipped<-!><-"><:f> <:s><:#293,9360><-"><-!><+!>C Prototype:<-!> extern void x_rect_pattern_clipped(WORD StartX, WORD StartY, WORD EndX, <:s><:#286,9360> WORD EndY, WORD PageBase, <:s><:#286,9360> BYTE far *Pattern); <:s><:#286,9360> <:s><:#293,9360><+">StartX, StartY<-"> - Coordinates of upper left hand corner of the rectangle. <:s><:#286,9360> <:s><:#293,9360><+">EndX, EndY<-"> - Coordinates of lower right hand corner of the rectangle. <:s><:#286,9360> <:s><:#293,9360><+">PageBase<-"> - Offset of the virtual screen. <:s><:#286,9360> <:#293,9360><+">Pattern<-"> - Pointer to the user defined pattern (16 bytes). <:s><:#286,9360> <:s><:#286,9360>Mode X rectangle 4x4 pattern fill routine. <:s><:#286,9360> <:s><:#1151,9360>Upper left corner of pattern is always aligned to a multiple of 4 row and column. Works on all VGAs. Uses approach of copying the pattern to off-screen display memory, then loading the latches with the pattern for each scan line and filling each scan line f our pixels at a time. Fills up to but not including the column at <+">EndX<-"> and the row at <+">EndY<-">. <+#>Clipping is performed<-#>. <:s><:#286,9360> <:s><:#579,9360><+!>WARNING:<-!> The VGA memory locations PATTERN_BUFFER (A000:FFFc) to A000:FFFF are reserved for the pattern buffer <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> <+#>Doctor Dobbs Journal<-#> references. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_rect_fill">x_rect_fill<-!><-"><:f><-"> <:s><:#293,9360><+!>C Prototype<-!>: extern void x_rect_fill(WORD StartX, WORD StartY, WORD EndX, <:s><:#286,9360> WORD EndY, WORD PageBase, WORD color); <:s><:#286,9360> <:s><:#293,9360><+">StartX, StartY<-"> - Coordinates of upper left hand corner of the rectangle. <:s><:#286,9360> <:s><:#293,9360><+">EndX, EndY<-"> - Coordinates of lower right hand corner of the rectangle. <:s><:#286,9360> <:s><:#293,9360><+">PageBase<-"> - Offset of the virtual screen. <:s><:#286,9360> <:s><:#293,9360><+">Color<-"> -color to use for fill <:s><:#286,9360> <:s><:#286,9360>Mode X rectangle solid color fill routine. <:s><:#286,9360> <:#286,9360>Based on code originally published in DDJ Magazine by M. Abrash <:s><:#286,9360> <:s><+!>See Also:<-!> <+#>Doctor Dobbs Journal<-#> references.<:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_rect_fill_clipped<:X11,-32768;TOC 3 "x_rect_fill_clipped"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype<-!>: extern void x_rect_fill_clipped(WORD StartX, WORD StartY, WORD EndX, <:s><:#286,9360> WORD EndY, WORD PageBase, WORD color); <:s><:#286,9360> <:s><:#293,9360><+">StartX, StartY<-"> - Coordinates of upper left hand corner of the rectangle. <:s><:#286,9360> <:s><:#293,9360><+">EndX, EndY<-"> - Coordinates of lower right hand corner of the rectangle. <:s><:#286,9360> <:s><:#293,9360><+">PageBase<-"> - Offset of the virtual screen. <:s><:#286,9360> <:s><:#293,9360><+">Color<-"> - The color to use for fill. <:s><:#286,9360> <:s><:#286,9360>Mode X rectangle solid color fill (With clipping) routine. <:s><:#286,9360> <:#286,9360>Based on code originally published in DDJ Magazine by M. Abrash <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> <+#>Doctor Dobbs Journal<-#> references. <:s><:#286,9360> <:s><:#286,9360> <:s><:p<* >> <:#333,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_cp_vid_rect">x_cp_vid_rect<-"><-!> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_cp_vid_rect(WORD SourceStartX, WORD SourceStartY, <:s><:#286,9360> WORD SourceEndX, WORD SourceEndY, <:s><:#286,9360> WORD DestStartX, WORD DestStartY, <:s><:#286,9360> WORD SourcePageBase, WORD DestPageBase, <:s><:#286,9360> WORD SourceBitmapWidth, WORD DestBitmapWidth); <:s><:#286,9360> <:s><:#293,9360><+">StartX, StartY<-">- Coordinates of the upper left hand corner of the source rectangle. <:s><:#286,9360> <:s><:#293,9360><+">EndX, EndY<-"> - Coordinates of the lower right hand corner of the source rectangle. <:s><:#286,9360> <:s><:#293,9360><+">DestStartX, DestStartY<-"> - Coordinates of the rectangle's destination. <:s><:#286,9360> <:s><:#293,9360><+">SourcePageBase<-"> - Source rectangle page offset. <:s><:#286,9360> <:s><:#293,9360><+">DestPageBase<-"> - Destination rectangle's page offset. <:s><:#286,9360> <:s><:#579,9360><+">SourceBitmapWidth<-"> - The width of bitmap within the source virtual screen containing the source rectangle <:s><:#286,9360> <:s><:#579,9360><+">DestBitmapWidth<-"> - The width of bitmap within the dest. virtual screen containing the destination rectangle <:s><:#286,9360> <:s><:#1151,9360>Mode X display memory to display memory copy routine. Left edge of source rectangle modulo 4 must equal left edge of destination rectangle modulo 4. Works on all VGAs. Uses approach of reading 4 pixels at a time from the source into the latches, then writin g the latches to the destination. Copies up to but not including the column at <+">SrcEndX<-"> and the row at <+">SrcEndY<-">. <:s><:#293,9360><+#>No clipping is performed<-#>. <+!>Results are not guaranteed if the source and destination overlap<-!>. <:s><:#286,9360> <:#286,9360>Based on code originally published in DDJ Magazine by M. Abrash <:s><:#286,9360> <:s><+!>See Also:<-!> <+#>Doctor Dobbs Journal<-#> references.<:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_shift_rect<:X11,-32768;TOC 3 "x_shift_rect"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_shift_rect (WORD SrcLeft, WORD SrcTop, WORD SrcRight, <:s><:#286,9360> WORD SrcBottom, WORD DestLeft, WORD DestTop, <:s><:#286,9360> WORD ScreenOffs); <:s><:#286,9360> <:s><:#293,9360><+">SrcLeft, SrcTop<-"> - Coordinates of the upper left hand corner of the rectangle. <:s><:#286,9360> <:s><:#293,9360><+">SrcRight, SrcBottom <-">- Coordinates of the lower right hand corner of the rectangle. <:s><:#286,9360> <:s><:#293,9360><+">DestLeft, DestTop<-"> - Coordinates of the upper left corner of the destination. <:s><:#286,9360> <:s><:#293,9360><+">ScreenOffs<-"> - Offset of the virtual screen. <:s><:#286,9360> <:s><:#1716,9360>This function copies a rectangle of VRAM onto another area of VRAM, even if the destination overlaps with the source. It is designed for scrolling text up and down, and for moving large areas of screens around in tiling systems. It rounds all horizontal coordinates to the nearest byte (4-column chunk) for the sake of speed. This means that <+#>it can NOT perform smooth horizontal scrolling<-#>. For that, either scroll the whole screen (minus the split screen), or copy smaller areas through system memory using the functions in the XPBITMAP module. <:s><:#286,9360> <:#879,9360><+">SrcRight<-"> is rounded up, and the left edges are rounded down, to ensure that the pixels pointed to by the arguments are inside the rectangle. That is, <+">SrcRight<-"> is treated as (<+">SrcRight<-">+3) <;><;> 2, and <+">SrcLeft<-"> as <+">SrcLeft <-"><;><;> 2. <:s><:#286,9360> <:s><+!>NOTE:<-!> The width of the rectangle in bytes (width in pixels / 4) cannot exceed 255.<:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XPAL<:X11,-32768;TOC 1 "MODULE XPAL"><-!><:f> <:s><:#286,9360> <:s><:#286,9360>Palette functions for VGA 256 color modes. <:s><:#286,9360> <:#572,9360>All the functions in this module operate on two variations of the palette buffer, the raw and annotated buffers. <:s><:#286,9360> <:s><:#865,9360>All those functions ending in "raw" operate on the following palette structure: <+">BYTE:r0,g0,b0,r1,g1,b1,...rn,gn,bn<-"> No reference to the starting color index or number of colors stored is contained in the structure. <:s><:#286,9360> <:s><:#286,9360>All those functions ending in "struc" operate on the following palette structure: <:s><:#579,9360><+">BYTE:c,BYTE:n,BYTE:r0,g0,b0,r1,g1,b1,...rn,gn,bn<-"> where<+"> c<-"> is the starting color and<+"> n<-"> is the number of colors stored <:s><:#286,9360> <:s><:#579,9360><+!>WARNING:<-!> <+#>There is no validity checking in these functions<-#>. The onus is on the user to supply valid parameters to the functions. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>SOURCES<:X11,-32768;TOC 2 "SOURCES"><-!> <:s><:#286,9360> xpal.asm <:s><:#286,9360> xpal.inc <:s><:#286,9360> xlib.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:s><:#286,9360> xpal.h <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!> <:s><:#286,9360> <:#333,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_get_pal_raw">x_get_pal_raw<-"><-!> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_get_pal_raw(BYTE far * pal,WORD num_clrs, WORD index); <:s><:#286,9360> <:#293,9360><+">pal<-"> - Pointer to a buffer to receive the raw palette. <:s><:#286,9360> <:s><:#293,9360><+">num_clrs<-"> - The number of colors to get. <:s><:#286,9360> <:s><:#293,9360><+">index <-">- Starting color number to get. <:s><:#286,9360> <:#286,9360>Read DAC palette into raw buffer with interrupts disabled i.e. BYTE r1,g1,b1,r1,g2,b2...rn,gn,bn <:s><:#286,9360> <:s><:#293,9360><+!>WARNING:<-!> Memory for the palette buffers must all be pre-allocated. <:s><:#286,9360><+!><+"> <:s><:#286,9360><+!><+"> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_get_pal_struc<:X11,-32768;TOC 3 "x_get_pal_struc"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_get_pal_struc(BYTE far *pal, WORD num_clrs, WORD index); <:s><:#286,9360> <:#293,9360><+">pal<-"> - Pointer to a buffer to receive the palette structure. <:s><:#286,9360> <:s><:#293,9360><+">num_clrs <-">- The number of colors to get. <:s><:#286,9360> <:s><:#293,9360><+">index <-">- The starting color number to get. <:s><:#286,9360> <:#572,9360>Read DAC palette into annotated type buffer with interrupts disabled i.e. BYTE colors to skip, BYTE colors to set, r1,g1,b1,r1,g2,b2...rn,gn,bn <:s><:#286,9360> <:s><:#293,9360><+!>WARNING:<-!> Memory for the palette buffers must all be pre-allocated. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_put_pal_raw">x_put_pal_raw<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_put_pal_raw(BYTE far *pal, WORD num_clrs, WORD index); <:s><:#293,9360><+"> <:#293,9360><+">pal<-"> - Pointer to a buffer containing the raw palette. <:s><:#286,9360> <:s><:#293,9360><+">num_clrs<-"> - The number of colors to put. <:s><:#286,9360> <:s><:#293,9360><+">index <-">- Starting color number to put. <:s><:#286,9360> <:#572,9360>Write DAC palette from raw buffer with interrupts disabled i.e. BYTE r1,g1,b1,r1,g2,b2...rn,gn,bn <:s><:#286,9360> <:s><:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_put_pal_struc<:X11,-32768;TOC 3 "x_put_pal_struc"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_put_pal_struc(BYTE far * pal); <:s><:#293,9360><+"> <:#293,9360><+">pal<-"> - Pointer to a buffer containing the palette structure. <:s><:#286,9360> <:#572,9360>Write DAC palette from annotated type buffer with interrupts disabled i.e. BYTE colors to skip, BYTE colors to set, r1,g1,b1,r1,g2,b2...rn,gn,bn <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_set_rgb">x_set_rgb <-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern x_set_rgb(BYTE color,BYTE red_c,BYTE green_c, BYTE blue_c); <:s><:#286,9360> <:s><:#293,9360><+">color<-"> - The color number to modify. <:s><:#286,9360> <:s><:#293,9360><+">red_c <-">- The red component for this color. <:s><:#286,9360> <:s><:#293,9360><+">green_c<-"> - The green component for this color. <:s><:#286,9360> <:s><:#293,9360><+">blue_c<-"> - The blue component for this color. <:s><:#286,9360> <:s><:#286,9360>Set the RGB components of a VGA color <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_rot_pal_struc">x_rot_pal_struc<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_rot_pal_struc(BYTE far * pal, WORD direction); <:s><:#286,9360> <:#293,9360><+">pal <-">- Pointer to the palette structure to rotate. <:s><:#286,9360> <:s><:#293,9360><+">direction<-"> - The direction to rotate the palette. <:s><:#286,9360> <:s><:#286,9360>Rotate annotated palette buffer entries. Direction 0 = backward, 1 = forward. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_rot_pal_raw">x_rot_pal_raw<-"><-!><:f> <:s><:#293,9360><+!>C Prototype<-!>: extern x_rot_pal_raw(BYTE far * pal, WORD direction, WORD num_colrs); <:s><:#286,9360> <:#293,9360><+">pal<-"> - Pointer to the raw palette buffer to rotate. <:s><:#286,9360> <:s><:#293,9360><+">direction<-"> - The direction to rotate the palette. <:s><:#286,9360> <:s><:#293,9360><+">num_colrs<-"> - The number of colors in the buffer. <:s><:#286,9360> <:s>Rotate a raw palette buffer. Direction 0 = backward, 1 = forward.<:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_put_contrast_pal_struc<:X11,-32768;TOC 3 "x_put_contrast_pal_struc"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_put_contrast_pal_struc(BYTE far * pal, BYTE intensity); <:s><:#286,9360> <:#293,9360><+">pal<-"> - A pointer to the palette structure to modify. <:s><:#286,9360> <:s><:#293,9360><+">intensity<-"> - Number of units to decrement the palette. <:s><:#286,9360> <:#572,9360>Write DAC palette from annotated type buffer with specified intensity adjustment (i.e. palette entries are decremented where possible by "intensity" units). <:s><:#286,9360>Designed for fading in or out a palette without using an intermediate working palette buffer! <:#286,9360>(Slow but memory efficient ... OK for small pal structs} <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_transpose_pal_struc">x_transpose_pal_struc<-"><-!><:f> <:s><:#293,9360><+!>C Prototype<-!>: extern void x_transpose_pal_struc(BYTE far * pal, WORD StartColor); <:s><:#286,9360> <:#293,9360><+">pal <-">- Pointer to the palette structure to modify. <:s><:#286,9360> <:s><:#293,9360><+">StartColor<-"> - Starting color index. <:s><:#286,9360> <:s><:#572,9360>Write DAC palette from annotated type buffer with interrupts disabled starting at a new palette index. <:s><:#286,9360><+!><+"> <:s><:#286,9360><+!><+"> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_cpcontrast_pal_struc">x_cpcontrast_pal_struc<-"><-!><:f> <:#293,9360><+!>C Prototype<-!>: extern WORD x_cpcontrast_pal_struc(BYTE far *src_pal, BYTE far *dest_pal, <:s><:#286,9360> BYTE Intensity); <:s><:#286,9360> <:#293,9360><+">src_pal<-"> - Pointer to the source palette structure. <:s><:#286,9360> <:#293,9360><+">dest_pal<-"><+"> <-">- Pointer to the destination palette structure. <:s><:#286,9360> <:s><:#293,9360><+">Intensity<-"> - Number of units to decrement the palette. <:s><:#286,9360> <:s>Copy one annotated palette buffer to another making the intensity adjustment. Used in fading in and out fast and smoothly.<:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XLINE<:X11,-32768;TOC 1 "MODULE XLINE"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360>Line Drawing functions. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>SOURCES<:X11,-32768;TOC 2 "SOURCES"><-!> <:s><:#286,9360> xline.asm <:s><:#286,9360> xline.inc <:s><:#286,9360> xlib.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:s><:#286,9360> xline.h <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_line<:X11,-32768;TOC 3 "x_line"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype: <-!>extern void x_line(WORD x0,WORD y0,WORD x1,WORD y1, <:s><:#286,9360> WORD color,WORD PageBase); <:s><:#286,9360> <:s><:#293,9360><+">x0<-"> - Starting X coordinate. <:s><:#286,9360> <:s><:#293,9360><+">y0<-"> - Starting Y coordinate. <:s><:#286,9360> <:s><:#293,9360><+">x1<-"> - Ending X coordinate <:s><:#286,9360> <:#293,9360><+">y1 <-">- Ending Y coordinate. <:s><:#286,9360> <:s><:#293,9360><+">color<-"> - The color to use for the line. <:s><:#286,9360> <:#293,9360><+">PageBase<-"> - The page offset on which to draw the line. <:s><:#286,9360> <:s><:#286,9360>Draw a line with the specified end points in the specified page. <:s><+#>No Clipping is performed<-#>.<:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XTEXT<:X11,-32768;TOC 1 "MODULE XTEXT"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360>Mode X text display functions. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>SOURCES<:X11,-32768;TOC 2 "SOURCES"><-!> <:s><:#286,9360> xtext.asm <:s><:#286,9360> xtext.inc <:s><:#286,9360> xlib.inc <:s><:#286,9360> model.inc <:s><:#286,9360> xprintf.c <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>C HEADER FILE<:X11,-32768;TOC 2 "C HEADER FILE"><-!> <:s><:#286,9360> xtext.h <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "MACROS">MACROS<-!> <:s><:#286,9360> FONT_8x8 0 <:s><:#286,9360> FONT_8x15 1 <:s><:#286,9360> FONT_USER 2 <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>EXPORTED VARIABLES<:X11,-32768;TOC 2 "EXPORTED VARIABLES"><-!> <:s><:#286,9360> <:s><:#293,9360><+!>NOTE:<-!> <+#>All variables are read only<-#>. If you modify them the results may be unpredictable. <:s><:#286,9360> <:s><:#293,9360><+">CharHeight<-"> BYTE - Height of current inbuilt character set. <:s><:#286,9360> <:s><:#293,9360><+">CharWidth<-"> BYTE - Width of current inbuilt character set. <:s><:#286,9360> <:s><:#293,9360><+">FirstChar<-"> BYTE - First character of current inbuilt character set. <:s><:#286,9360> <:s><:#293,9360><+">UserCharHeight<-"> BYTE - Height of current user character set. <:s><:#286,9360> <:s><:#293,9360><+">UserCharWidth<-"> BYTE - Width of current user character set. <:s><:#286,9360> <:s><:#293,9360><+">UserFirstCh<-"> BYTE - First character of current user character set. <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_text_init">x_text_init<-"><-!><:f> <:#293,9360><+!>C Prototype<-!>: extern WORD x_text_init( void); <:s><:#286,9360> <:s><:#286,9360>Initializes the Mode X text driver and sets the default font (VGA ROM 8x8) <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_set_font">x_set_font<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_set_font(WORD FontId); <:s><:#286,9360> <:s><:#293,9360><+">FontId<-"> - The font number you wish to use (See below) <:s><:#286,9360> <:s><:#572,9360>Select the working font where 0 = VGA ROM 8x8, 1 = VGA ROM 8x14 2 = User defined bitmapped font. <:s><:#286,9360> <:s><:#293,9360><+!>WARNING:<-!> A user font must be registered before setting <+">FontID<-"> to 2. <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> Defines for this module. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_register_userfont">x_register_userfont<-"><-!><:f> <:#293,9360><+!>C Prototype:<-!> extern void x_register_userfont( char far *UserFontPtr); <:s><:#286,9360> <:s><:#293,9360><+">UserFontPtr<-"> - A pointer to the user font structure. <:s><:#286,9360> <:s><:#572,9360>Register a user font for later selection. Only one user font can be registered at any given time. Registering a user font deregisters the previous user font. User fonts may be at most 8 pixels wide. <:s><:#286,9360> <:s><:#286,9360><+!>USER FONT STRUCTURE<-!> <:#286,9360> Word: ASCII code of first char in font <:s><:#286,9360> Byte: Height of chars in font <:s><:#286,9360> Byte: Width of chars in font <:s><:#286,9360> n*h*Byte: the font data where n = number of chars and h = height of chars <:s><:#286,9360> <:s><:#579,9360><+!>WARNING:<-!> The onus is on the program to ensure that all characters drawn whilst this font is active, are within the range of characters defined. <:s><:#286,9360> <:s><:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_char_put<:X11,-32768;TOC 3 "x_put_char"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_char_put(char ch,WORD X,WORD Y,WORD PgOffs, <:s><:#286,9360> WORD Color); <:s><:#286,9360> <:s><:#293,9360><+">ch<-"> - Char to draw <:s><:#286,9360> <:#293,9360><+">x, y <-">- Screen coordinates at which to draw ch <:s><:#286,9360> <:#293,9360><+">ScrnOffs<-"> - Starting offset of page on which to draw <:s><:#286,9360> <:s><:#293,9360><+">Color<-"> - Color of the text <:s><:#286,9360> <:s><:#286,9360>Draw a text character at the specified location with the specified color. <:s><:#286,9360><+!> <:s><:#293,9360><+!>WARNING:<-!> InitTextDriver must be called before using this function <:s><:#286,9360> <:s><:#286,9360> <:#333,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_printf ">x_printf<-"> <-!><:f> <:s><:#293,9360><+!>C Prototype<-!>: void x_printf(int x, int y, unsigned ScrnOffs, int color, char *ln,...); <:s><:#286,9360> <:#293,9360><+">x, y <-">- screen coordinates at which to draw ch <:s><:#286,9360> <:#293,9360><+">ScrnOffs<-"> - Starting offset of page on which to draw <:s><:#286,9360> <:s><:#293,9360><+">Color<-"> - Color of the text <:s><:#286,9360> <:s><:#293,9360><+">ln<-"> - A pointer to a text string containing formating codes. <:s><:#286,9360> <:s><:#293,9360>Parameters beyond <+">Color<-"> conform to the standard printf parameters. <:s><:#286,9360> <:s><:#286,9360>Display formated text in the specified color. <:s><:#286,9360> <:s><:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_bgprintf">x_bgprintf<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> void x_bgprintf(int x, int y, unsigned ScrnOffs, int fgcolor, int bgcolor, char *ln,...); <:s><:#286,9360> <:#293,9360><+">x, y<-"> - Screen coordinates at which to draw ch. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs<-"> - Page offset on which to draw. <:s><:#286,9360> <:s><:#293,9360><+">fgcolor<-"> - Color of the text foreground. <:s><:#286,9360> <:s><:#293,9360><+">bgcolor<-"> - Color of the text background. <:s><:#286,9360> <:s><:#579,9360><+">ln<-"> - Pointer to a text string that contains formating commands that conform to the printf commands. <:s><:#286,9360> <:#293,9360>Parameters beyond <+">bgcolor<-"> conform to the standard printf parameters. <:s><:#286,9360> <:s><:#286,9360>Display formatted text in the specified foreground and background colors. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_get_char_width">x_get_char_width<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> unsigned int x_get_char_width(char ch) <:s><:#286,9360> <:s><:#293,9360><+">ch <-">- Character to get the width of. <:s><:#286,9360> <:s><+!>Returns:<-!> The width the requested character.<:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XPBITMAP<:X11,-32768;TOC 1 "MODULE XPBITMAP"><-!><:f> <+B><:s><:#286,9360> <:s><:#286,9360> <:s><:#572,9360>This module implements a set of functions to operate on planar bitmaps. Planar bitmaps as used by these functions have the following structure: <:s><:#286,9360> <:s><:#286,9360> BYTE 0 The bitmap width in bytes (4 pixel groups) range 1..255 <:s><:#286,9360> BYTE 1 The bitmap height in rows range 1..255 <:s><:#286,9360> BYTE 2..n1 The plane 0 pixels width*height bytes <:s><:#286,9360> BYTE n1..n2 The plane 1 pixels width*height bytes <:s><:#286,9360> BYTE n2..n3 The plane 2 pixels width*height bytes <:s><:#286,9360> BYTE n3..n4 The plane 3 pixels width*height bytes <:s><:#286,9360> <:#1144,9360>These functions provide the fastest possible bitmap blts from system ram to video and further, the single bitmap is applicable to all pixel alignments. The masked functions do not need separate masks since all non zero pixels are considered to be masking pi xels, hence if a pixel is 0 the corresponding screen destination pixel is left unchanged. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>SOURCES<:X11,-32768;TOC 2 "SOURCES"><-!> <:s><:#286,9360> xpbitmap.asm <:s><:#286,9360> xpbitmap.inc <:s><:#286,9360> xlib.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:s><:#286,9360> xpbitmap.h <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!><:X11,-32768;TOC 2 "EXPORTED FUNCTIONS">EXPORTED FUNCTIONS<-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_put_masked_pbm">x_put_masked_pbm<-"><-!><:f> <:s><:#293,9360><+!>C Prototype<-!>: extern void x_put_masked_pbm(WORD X, WORD Y, WORD ScrnOffs, <:s><:#286,9360> BYTE far * Bitmap); <:s><:#286,9360> <:s><:#293,9360><+">x, y<-"> - Coordinates for the upper left corner of the bitmap. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs <-">- Page offset to place the bitmap at. <:s><:#286,9360> <:#293,9360><+">Bitmap<-"> - Pointer to the planar bitmap structure. <:s><:#286,9360> <:s><:#572,9360>Mask write a planar bitmap from system ram to video ram. All zero source bitmap bytes indicate destination byte to be left unchanged. <:s><:#286,9360><+!> <:#293,9360><+!>NOTE<-!><+!>: <-!>Width is in bytes i.e. lots of 4 pixels <:s><:#286,9360> <:s><:#579,9360><+!>LIMITATIONS:<-!> <+#>No clipping is supported.<-#> Only supports bitmaps with widths which are a multiple of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> XBMTOOLS module for linear <<-<;> planar bitmap conversion functions. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_put_pbm">x_put_pbm<-"><-!><:f> <:s><:#293,9360><+!>C Prototype<-!>: extern void x_put_pbm(WORD X, WORD Y, WORD ScrnOffs, <:s><:#286,9360> BYTE far *Bitmap); <:s><:#286,9360> <:s><:#293,9360><+">x, y<-"> - Coordinates for the upper left corner of the bitmap. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs <-">- Page offset to place the bitmap at. <:s><:#286,9360> <:#293,9360><+">Bitmap<-"> - Pointer to the planar bitmap structure. <:s><:#286,9360> <:s><:#286,9360>Write a planar bitmap from system ram to video ram. <:s><:#286,9360> <:#293,9360><+!>NOTE:<-!> Width is in bytes i.e. lots of 4 pixels <:s><:#286,9360> <:s><:#579,9360><+!>LIMITATIONS:<-!> <+#>No clipping is supported<-#> Only supports bitmaps with widths which are a multiple of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> XBMTOOLS module for linear <<-<;> planar bitmap conversion functions. <:s><:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_get_pbm<:X11,-32768;TOC 3 "x_get_pbm"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_get_pbm(WORD X, WORD Y,BYTE Bw,BYTE Bh, <:s><:#286,9360> WORD ScrnOffs, BYTE far * Bitmap); <:s><:#286,9360> <:s><:#293,9360><+">X, Y<-"> - Coordinates of the upper left corner of the bitmap. <:s><:#286,9360> <:s><:#293,9360><+">Bw <-">- Width of the bitmap to get. <:s><:#286,9360> <:s><:#293,9360><+">Bh<-"> - Height of the bitmap to get. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs<-"> - Page offset to get the bitmap from. <:s><:#286,9360> <:s><:#293,9360><+">Bitmap<-"> - Pointer to a buffer allocated for receiveing this bitmap. <:s><:#286,9360> <:s><:#286,9360>Read a planar bitmap to system ram from video ram. <:s><:#286,9360> <:s><:#293,9360><+!>NOTE:<-!> Width is in bytes in lots of 4 pixels <:s><:#286,9360> <:s><:#579,9360><+!>LIMITATIONS:<-!> No clipping is supported. Only supports bitmaps with widths which are a multiple of 4 pixels <:s><:#286,9360> <:s><+!>See Also:<-!> XBMTOOLS module for linear <<-<;> planar bitmap conversion functions.<:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XPBMCLIP<:X11,-32768;TOC 1 "MODULE XPBMCLIP"><-!><:f> <:s><:#286,9360> <:s><:#865,9360>This module implements a similar set of functions to operate on planar bitmaps as XPBITMAP but incorporates clipping to a user defined clipping rectangle (which is set by <+!><+">x_set_cliprect<-"><-!> in module XMAIN). <:s><:#286,9360> <:s><:#286,9360>The planar bitmap format is identical to the above module <:s><:#286,9360> <:#2288,9360>There are three variations of the functions in XPBITMAP in this module identified by the three function name extensions: _clipx, _clipy _clipxy. <+#>Because speed is critical in games programming you do not want to be checking for clipping if not necessary<-#> thus for sprites that move only horizontally you would use the _clipx version of the put function, for sprites that move vertically you woul d use the _clipy version and for sprites that move both directions you would use the clipxy version. Keep in mind also that <+#>the clipping components of these functions assume that the clipping rectangle is equal to or larger than the size of the bitmap<-#> i.e.. if a bitmap is top clipped, it is assumed that the bitmap's bottom is not also clipped. Similarly with horizontal c lipping. <:s><:#286,9360> <:s><:#579,9360><+!>Note:<-!> Performance in decreasing order is as follows. _clipy,_clipx,_clipxy with masked puts being slower than unmasked puts. <:s><:#286,9360> <:s><:#1144,9360>Horizontal clipping is performed to byte boundaries (4 pixels) rather than pixels. This allows for the fastest implementation of the functions. It is not such a handicap because for one, your screen width a multiple of 4 pixels wide and for most purposes i t is the screen edges that form the clipping rectangle. <:s><:#286,9360> <:s><:#286,9360>Following is an example of setting a clipping rectangle to the logical screen edges: <:s><:#286,9360> x_set_cliprect(0,0,ScrnLogicalByteWidth,ScrnLogicalHeight) <:s><:#286,9360> <:#579,9360><+!>NOTE:<-!> The functions now return a value; 1 if clipped image is fully clipped (i.e. no portion of it appears on the screen) otherwise it returns 0 <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>SOURCES<:X11,-32768;TOC 2 "SOURCES"><-!> <:s><:#286,9360> xpbmclip.asm <:s><:#286,9360> xpbmclip.inc <:s><:#286,9360> xlib.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:s><:#286,9360> xpbmclip.h <:s><:#286,9360> <:s><:#286,9360> <:p<* >><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_put_masked_pbm_clipx">x_put_masked_pbm_clipx<-"><-!><:f> <:s><:#293,9360><+!>C Prototype<-!>: extern void x_put_masked_pbm_clipx(WORD X, WORD Y, WORD ScrnOffs, <:s><:#286,9360> BYTE far * Bitmap); <:s><:#286,9360> <:s><:#293,9360><+">x, y<-"> - Coordinates for the upper left corner of the bitmap. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs <-">- Page offset to place the bitmap at. <:s><:#286,9360> <:#293,9360><+">Bitmap<-"> - A far pointer to the planar bitmap structure. <:s><:#286,9360> <:s><:#572,9360>Mask write a planar bitmap from system ram to video ram. Horizontal clipping is performed. All zero source bitmap bytes indicate destination byte to be left unchanged. <:s><:#286,9360><+!> <:#293,9360><+!>NOTE<-!><+!>: <-!>Width is in bytes i.e. lots of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>LIMITATIONS:<-!> Only supports bitmaps with widths which are a multiple of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> XBMTOOLS module for linear <<-<;> planar bitmap conversion functions. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><-!><-"><:f280, Times New Roman,0,0,0><+!><+">x_put_masked_pbm_clipy<:X11,-32768;TOC 3 "x_put_masked_pbm_clipy"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype<-!>: extern void x_put_masked_pbm_clipy(WORD X, WORD Y, WORD ScrnOffs, <:s><:#286,9360> BYTE far * Bitmap); <:s><:#286,9360> <:s><:#293,9360><+">x, y<-"> - Coordinates for the upper left corner of the bitmap. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs <-">- Page offset to place the bitmap at. <:s><:#286,9360> <:#293,9360><+">Bitmap<-"> - A far pointer to the planar bitmap structure. <:s><:#286,9360> <:#572,9360>Mask write a planar bitmap from system ram to video ram. Vertical clipping is performed. All zero source bitmap bytes indicate destination byte to be left unchanged. <:s><:#286,9360><+!> <:#293,9360><+!>NOTE<-!><+!>: <-!>Width is in bytes i.e. lots of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>LIMITATIONS:<-!> Only supports bitmaps with widths which are a multiple of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> XBMTOOLS module for linear <<-<;> planar bitmap conversion functions. <:s><:#326,9360><+!><+"><:f280, Times New Roman,0,0,0> <:s><+!><+"><:f280, Times New Roman,0,0,0><:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_put_masked_pbm_clipxy<:X11,-32768;TOC 3 "x_put_masked_pbm_clipxy"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype<-!>: extern void x_put_masked_pbm_clipxy(WORD X, WORD Y, WORD ScrnOffs, <:s><:#286,9360> BYTE far * Bitmap); <:s><:#286,9360> <:s><:#293,9360><+">x, y<-"> - Coordinates for the upper left corner of the bitmap. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs <-">- Page offset to place the bitmap at. <:s><:#286,9360> <:#293,9360><+">Bitmap<-"> - A far pointer to the planar bitmap structure. <:s><:#286,9360> <:#572,9360>Mask write a planar bitmap from system ram to video ram. Both horizontal and vertical clipping is performed. All zero source bitmap bytes indicate destination byte to be left unchanged. <:s><:#286,9360><+!> <:#293,9360><+!>NOTE<-!><+!>: <-!>Width is in bytes i.e. lots of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>LIMITATIONS:<-!> Only supports bitmaps with widths which are a multiple of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> XBMTOOLS module for linear <<-<;> planar bitmap conversion functions. <:s><:#326,9360><+!><+"><:f280, Times New Roman,0,0,0> <:s><:#326,9360><+!><+"><:f280, Times New Roman,0,0,0> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_put_pbm<-"><-!><+!><+">_clipx<:X11,-32768;TOC 3 "x_put_pbm_clipx"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype<-!>: extern void x_put_pbm_clipx(WORD X, WORD Y, WORD ScrnOffs, <:s><:#286,9360> BYTE far *Bitmap); <:s><:#286,9360> <:s><:#293,9360><+">x, y<-"> - Coordinates for the upper left corner of the bitmap. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs <-">- Page offset to place the bitmap at. <:s><:#286,9360> <:#293,9360><+">Bitmap<-"> - A far pointer to the planar bitmap structure. <:s><:#286,9360> <:s><:#286,9360>Write a planar bitmap from system ram to video ram. Horizontal clipping is performed. <:s><:#286,9360> <:#293,9360><+!>NOTE:<-!> Width is in bytes i.e. lots of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>LIMITATIONS:<-!> Only supports bitmaps with widths which are a multiple of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> XBMTOOLS module for linear <<-<;> planar bitmap conversion functions. <:s><:p<* >> <:#326,9360><+!><+"><:f280, Times New Roman,0,0,0>x_put_pbm<-"><-!><:f><+!><+">_clipy<:X11,-32768;TOC 3 "x_put_pbm_clipy"><-"><-!> <:s><:#293,9360><+!>C Prototype<-!>: extern void x_put_pbm_clipy(WORD X, WORD Y, WORD ScrnOffs, <:s><:#286,9360> BYTE far *Bitmap); <:s><:#286,9360> <:s><:#293,9360><+">x, y<-"> - Coordinates for the upper left corner of the bitmap. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs <-">- Page offset to place the bitmap at. <:s><:#286,9360> <:#293,9360><+">Bitmap<-"> - A far pointer to the planar bitmap structure. <:s><:#286,9360> <:#286,9360>Write a planar bitmap from system ram to video ram. Vertical clipping is performed. <:s><:#286,9360> <:#293,9360><+!>NOTE:<-!> Width is in bytes i.e. lots of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>LIMITATIONS:<-!> Only supports bitmaps with widths which are a multiple of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> XBMTOOLS module for linear <<-<;> planar bitmap conversion functions. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><+!><+"><:f280, Times New Roman,0,0,0>x_put_pbm<-"><-!><:f><+!><+">_clipxy<:X11,-32768;TOC 3 "x_put_pbm_clipxy"><-"><-!> <:s><:#293,9360><+!>C Prototype<-!>: extern void x_put_pbm_clipxy(WORD X, WORD Y, WORD ScrnOffs, <:s><:#286,9360> BYTE far *Bitmap); <:s><:#286,9360> <:s><:#293,9360><+">x, y<-"> - Coordinates for the upper left corner of the bitmap. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs <-">- Page offset to place the bitmap at. <:s><:#286,9360> <:#293,9360><+">Bitmap<-"> - A far pointer to the planar bitmap structure. <:s><:#286,9360> <:#572,9360>Write a planar bitmap from system ram to video ram. Both horizontal and vertical clipping is performed. <:s><:#286,9360> <:#293,9360><+!>NOTE:<-!> Width is in bytes i.e. lots of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>LIMITATIONS:<-!> Only supports bitmaps with widths which are a multiple of 4 pixels <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> XBMTOOLS module for linear <<-<;> planar bitmap conversion functions. <:s><:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XCBITMAP<:X11,-32768;TOC 1 "MODULE XCBITMAP"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:#572,9360>Compiled bitmap functions. See "The care and feeding of compiled masked blits." in the reference section for more details on compiled bitmaps. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "SOURCES">SOURCES<-!> <:#293,9360><+!> <-!>xcbitmap.asm <:#286,9360> xcbitmap.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> xcbitmap.h<:p<* >> <:#286,9360><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!> <:s><:#286,9360><+!> <:s><:#286,9360><+!> <:#326,9360><+!><+"><:f280, Times New Roman,0,0,0><:X11,-32768;TOC 3 "x_compile_bitmap">x_compile_bitmap<:f><-"> <:#293,9360><+!>C Prototype: <-!>int x_compile_bitmap( WORD lsw, char far *bitmap, char far *output ); <:s><:#286,9360> <:s><:#293,9360><+">lsw<-"> - The logical screen width in bytes. <:s><:#286,9360> <:s><:#293,9360><+">bitmap<-"> - A pointer to the source linear bitmap. <:s><:#286,9360> <:s><:#293,9360><+">output<-"> - A pointer to a buffer set up to receive the compiled bitmap. <:s><:#286,9360> <:s><:#293,9360><+!>Returns: <-!>The size of the compiled bitmap in bytes. <:s><:#286,9360> <:s><:#572,9360>Compiles a linear bitmap to generate machine code to plot it at any required screen coordinates FAST! <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><+!><+"><:f280, Times New Roman,0,0,0><:X11,-32768;TOC 3 "x_sizeof_cbitmap">x_sizeof_cbitmap<:f><-"><-!> <:s><:#293,9360><+!>C Prototype: <-!> int x_sizeof_cbitmap( WORD lsw, char far *bitmap ); <:s><:#286,9360> <:s><:#293,9360><+">lsw<-"> - The logical screen width in bytes. <:s><:#286,9360> <:s><:#293,9360><+">bitmap<-"> - A pointer to the source linear bitmap. <:s><:#286,9360> <:s><:#293,9360><+!>Returns: <-!> The space in bytes required to hold the compiled bitmap. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><+!><+"><:f280, Times New Roman,0,0,0><:X11,-32768;TOC 3 "x_put_cbitmap">x_put_cbitmap<:f><-"><-!> <:s><:#293,9360><+!>C Prototype: <-!>void x_put_cbitmap( int X, int Y, unsigned int PageOffset, char far *bitmap); <:s><:#286,9360> <:s><:#293,9360><+">X, Y<-"> - The coordinates at which to place the compiled bitmaps. <:s><:#286,9360> <:s><:#293,9360><+">PageOffset<-"> - The page offset on which to draw the bitmap. <:s><:#286,9360> <:s><:#293,9360><+">bitmap<-"> - A pointer to the compiled bitmap. <:s><:#286,9360> <:s><:#293,9360>Displays a bitmap generated by <+!><+">x_compile_bitmap<-!><-">.<-"> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XCOMPPBM<:X11,-32768;TOC 1 "MODULE XCOMPPBM"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:#286,9360>Identical to XCBITMAP except that the source bitmaps are the PBM form rather than LBM. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "SOURCES">SOURCES<-!> <:#286,9360> xcompbm.asm <:#286,9360> xcompbm.inc <:s><:#286,9360> <:s><:#286,9360><+!> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <+!> <-!>xcompbm.h<:p<* >> <:#286,9360><+!>EXPORTED <-!><+!>FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_compile_pbm">x_compile_pbm<-"><-!><:f> <:s><:#293,9360><+!>C Prototype: <-!> x_compile_pbm( WORD lsw, char far *bitmap, char far *output ); <:s><:#286,9360> <:s><:#293,9360><+">lsw<-"> - The logical screen width in bytes. <:s><:#286,9360> <:s><:#293,9360><+">bitmap<-"> - A pointer to the source planar bitmap. <:s><:#286,9360> <:s><:#293,9360><+">output<-"> - A far pointer to a buffer set up to receive the compiled bitmap. <:s><:#286,9360> <:s><:#293,9360><+!>Returns: <-!>The size of the compiled bitmap in bytes. <:s><:#286,9360> <:s><:#572,9360>Compiles a planar bitmap to generate machine code to plot it at any required screen coordinates FAST! <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><+!><+"><:f280, Times New Roman,0,0,0>x_sizeof_cpbm<:X11,-32768;TOC 3 "x_sizeof_cpbm"><:f><-"><-!> <:s><:#293,9360><+!>C Prototype: <-!> int x_sizeof_cpbm( WORD lsw, char far *bitmap ); <:s><:#286,9360> <:s><:#293,9360><+">lsw<-"> - The logical screen width in bytes. <:s><:#286,9360> <:s><:#293,9360><+">bitmap<-"> - A far pointer to the source planar bitmap. <:s><:#286,9360> <:s><:#293,9360><+!>Returns: <-!> The space in bytes required to hold the compiled bitmap. <:s><:#286,9360> <:s><:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XVBITMAP<:X11,-32768;TOC 1 "MODULE XVBITMAP"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:#1430,9360>The XVBITMAP module implements yet another type of bitmap to complement planar and compiled bitmaps, VRAM based bitmaps. If a 4 cylinder car is analogous to planar bitmaps, that is thrifty on memory consumption but low performance and a V8 is analogous to C ompiled bitmaps, memory guzzlers that really fly, then VRAM based bitmaps are the 6 cylinder modest performers with acceptable memory consumption. <:s><:#286,9360> <:#858,9360>To summarize their selling points, VBM's are moderately fast with fair memory consumption, and unlike compiled bitmaps, can be clipped. The disadvantages are that they are limited by the amount of free video ram and have a complex structure. <:s><:#286,9360> <:#1151,9360>The VRAM bitmap format is rather complex consisting of components stored in video ram and components in system ram working together. This complexity necessitates the existence of a creation function <+!><+">x_make_vbm<-"><-!> which takes an input linear bitmap and generates the equivalent VBM (VRAM Bit Map). <:s><:#286,9360> <:s><:#286,9360>VBM structure: <:s><:#286,9360> WORD 0 Size Total size of this VBM structure in bytes <:#286,9360> WORD 1 ImageWidth Width in bytes of the image (for all alignments) <:#286,9360> WORD 2 ImageHeight Height in scan lines of the image <:#286,9360> WORD 3 Alignment 0 ImagePtr Offset in VidRAM of this aligned image <:#286,9360> WORD 4 MaskPtr Offset (within this structure's DS) of alignment masks <:s><:#286,9360> WORD 9 Alignment 3 ImagePtr Offset in VidRAM of this aligned image <:s><:#286,9360> WORD 10 MaskPtr Offset (within this structure's DS) of alignment masks <:s><:#286,9360> BYTE 21 (WORD 11) <:s><:#286,9360> Image masks for alignment 0 <:#286,9360> BYTE 21 + ImageWidth*ImageHeight <:#286,9360> (similarly for alignments 1 - 2 ) <:#286,9360> BYTE 21 + 3*ImageWidth*ImageHeight + 1 <:s><:#286,9360> Image masks for alignment 3 <:#286,9360> BYTE 21 + 4*(ImageWidth*ImageHeight) <:s><:#286,9360> Similarly for alignments 2 and 3 <:s><:#286,9360> BYTE 21 + 4*(ImageWidth*ImageHeight) <:#286,9360> (And don't forget the corresponding data in video ram) <:s><:#286,9360> <:s><:#286,9360> You can see for yourself the complexity of this bitmap format. The image is stored in video ram in its 4 different alignments with pointers to these alignments in the VBM. Similarly there are 4 alignments of the corresponding masks within the VBM itself (to wards the end). The mask bytes contain the plane settings for the corresponding video bytes so that one memory move can move up to 4 pixels at a time (depending on the mask settings) using the VGA's latches, theoretically giving you a 4x speed improvement o ver conventional blits like the ones implemented in "XPBITMAP". In actual fact its anywhere between 2 and 3 due to incurred overheads. <:p<* >> <:#2002,9360>These bitmaps are more difficult to store in files than PBM'S and CBM's but still possible with a bit of work, so do not dismiss these as too difficult to use. Consider all the bitmap formats carefully before deciding on which to use. There may even be situ ations that a careful application of all three types would be most effective i.e.. compiled bitmaps for Background tiles and the main game character (which never need clipping), VRAM based bitmaps for the most frequently occurring (opponent, alien etc.) cha racters which get clipped as they come into and leave your current location and planar bitmaps for smaller or less frequently encountered characters. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>SOURCES<:X11,-32768;TOC 2 "SOURCES"><-!> <:#286,9360> xvbitmap.asm <:#286,9360> xvbitmap.inc <:s><:#286,9360> xlib.inc model.inc <:#286,9360> xmakevbm.c <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:#286,9360> xvbitmap.h <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!><:X11,-32768;TOC 2 "EXPORTED FUNCTIONS">EXPORTED FUNCTIONS<-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_make_vbm">x_make_vbm<-"><-!><:f> <:#293,9360><+!>C Prototype:<-!> extern char far * x_make_vbm( char far *lbm, WORD *VramStart); <:s><:#286,9360> <:#293,9360><+">lbm - <-">A far pointer to the input linear bitmap <:s><:#286,9360> <:#293,9360><+">VramStart<-"> - Pointer to variable containing Offset of first free VRAM byte <:s><:#286,9360> <:s><:#1158,9360>Create the VBM from the given linear bitmap and place the image alignments in video ram starting at the offset in the variable pointed to by <+">VramStart<-">. <+">VramStart<-"> is then updated to point to the next free VRAM byte (just after the last byte of the image alignments). Usually you will point <+">VramStart<-"> to <+">NonVisual_Offs<-">. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_put_masked_vbm<:X11,-32768;TOC 3 "x_put_masked_vbm"> <-"><-!><:f> <:#293,9360><+!>C Prototype:<-!> extern int x_put_masked_vbm( int X, int Y, WORD ScrnOffs, <:#286,9360> BYTE far *VBitmap); <:s><:#286,9360> <:s><:#293,9360><+">X, Y <-">- Coordinates to draw the bitmap at. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs<-"> - The page offset to draw the bitmap at. <:s><:#293,9360><+"> <:#293,9360><+">VBitmap<-"> - A far pointer to the video bitmap. <:s><:#286,9360> <:#832,9360><+!>Returns:<-!> 1 if clipped image is fully clipped (i.e. no portion of it appears on the screen) otherwise it returns 0. <:f200, NewsGothic,0,0,0>(Editors note: since this function doesn't support clipping the return value should be 0 at all times.)<:f> <:s><:#286,9360> <:s><:#293,9360>Draw a VRAM based bitmap at (X,Y) relative to the screen with starting offset <+">ScrnOffs<-">. <:s><:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_put_masked_vbm_clipx">x_put_masked_vbm_clipx<-!><-"><:f> <:#293,9360><-!><+!>C Prototype:<-!> extern int x_put_masked_vbm_clipx(int X, int Y, WORD ScrnOffs, <:s><:#286,9360> BYTE far *VBitmap); <:s><:#286,9360> <:s><:#293,9360><+">X, Y <-">- Coordinates to draw the bitmap at. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs<-"> - The page offset to draw the bitmap at. <:s><:#286,9360> <:s><:#293,9360><+">VBitmap<-"> - A far pointer to the video bitmap. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> 1 if clipped image is fully clipped otherwise it returns 0. <:s><:#286,9360> <:#579,9360>Draw a VRAM based bitmap at (X,Y) relative to the screen with starting offset <+">ScrnOffs. <-">Horizontal clipping is performed. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+"><+!>x_put_masked_vbm_clipy<:X11,-32768;TOC 3 "x_put_masked_vbm_clipy"><-!><-"> <:#293,9360><-!><+!>C Prototype:<-!> extern int x_put_masked_vbm_clipy( int X, int Y, WORD ScrnOffs, <:s><:#286,9360> BYTE far *VBitmap); <:s><:#286,9360> <:s><:#293,9360><+">X, Y <-">- Coordinates to draw the bitmap at. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs<-"> - The page offset to draw the bitmap at. <:s><:#286,9360> <:s><:#293,9360><+">VBitmap<-"> - A far pointer to the video bitmap. <:s><:#286,9360> <:#579,9360><+!>Returns:<-!> 1 if clipped image is fully clipped (i.e. no portion of it appears on the screen) otherwise it returns 0 <:s><:#286,9360> <:s><:#293,9360>Draw a VRAM based bitmap at (X,Y) relative to the screen with starting offset <+">ScrnOffs<-">. <:#286,9360>Vertical clipping is performed. <:s><:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+"><+!>x_put_masked_vbm_clipxy<:X11,-32768;TOC 3 "x_put_masked_vbm_clipxy"><-"><-!><:f> <:#293,9360><+!>C Prototype:<-!> extern int x_put_masked_vbm_clipxy( int X, int Y, WORD ScrnOffs, <:s><:#286,9360> BYTE far *VBitmap); <:s><:#286,9360> <:s><:#293,9360><+">X, Y <-">- Coordinates to draw the bitmap at. <:s><:#286,9360> <:s><:#293,9360><+">ScrnOffs<-"> - The page offset to draw the bitmap at. <:s><:#286,9360> <:s><:#293,9360><+">VBitmap<-"> - A far pointer to the video bitmap. <:s><:#286,9360> <:#579,9360><+!>Returns:<-!> 1 if clipped image is fully clipped (i.e. no portion of it appears on the screen) otherwise it returns 0 <:s><:#286,9360> <:s><:#293,9360>Draw a VRAM based bitmap at (X,Y) relative to the screen with starting offset <+">ScrnOffs<-">. <:#286,9360>Both horizontal and vertical clipping is performed. <:s><:#286,9360> <:s><:#286,9360> <:s>See XPBMCLIP for more details on the type of clipping used as it is identical to XVBITMAP.<:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XMOUSE<:X11,-32768;TOC 1 "MODULE XMOUSE"><-!><:f> <:s><:#286,9360> <:s><:#1144,9360>The XMOUSE module implements very basic mouse handling functions. The way in which it operates is by installing an event handler function during initialization which subsequently intercepts and processes mouse events and automatically updates status variabl es such as mouse position and button pressed status. <:s><:#286,9360> <:s><:#286,9360>It does not support the full functionality of: <:s><:#286,9360> SPLIT SCREENS, SCROLLED WINDOWS, or VIRTUAL WINDOWS <:#858,9360>This was done to primarily prevent unnecessary impedences to performance, since the mouse handler function has the potential to degrade performance. It also saves me a lot of coding which I was too lazy to do. <:s><:#286,9360> <:s><:#1144,9360>Programs communicate with the mouse driver as with other devices, through an interrupt vector namely 33h. On generating an interrupt, the mouse driver expects a function number in AX and possibly other parameters in other registers and returns information v ia the registers. A brief description of the mouse functions follows: <:s><:#286,9360> <:#286,9360><+!><+#><:X11,-32768;TOC 2 "MS Mouse Driver Functions">MS Mouse Driver Functions<-#><-!> <:s><:#286,9360>Mouse Initialization 0 <:s><:#286,9360>Show Cursor 1 <:s><:#286,9360>Hide Cursor 2 <:s><:#286,9360>Get Mouse Position & Button Status 3 <:s><:#286,9360>Set Mouse Cursor Position 4 <:s><:#286,9360>Get Button Press Information 5 <:s><:#286,9360>Get Button Release Information 6 <:s><:#286,9360>Set Min/Max Horizontal Position 7 <:s><:#286,9360>Set Min/Max Vertical Position 8 <:s><:#286,9360>Define Graphics Cursor Block 9 <:s><:#286,9360>Define Text Cursor 10 <:s><:#286,9360>Read Mouse Motion Counters 11 <:s><:#286,9360>Define Event Handler 12 <:s><:#286,9360>Light Pen Emulation Mode ON 13 <:s><:#286,9360>Light Pen Emulation Mode OFF 14 <:s><:#286,9360>Set Mouse Mickey/Pixel Ratio 15 <:s><:#286,9360>Conditional Hide Cursor 16 <:s><:#286,9360>Set Double-Speed Threshold 19 <:s><:#286,9360> <:s><:#286,9360> In practice only a few of these functions are used and even fewer when the mouse status is monitored by an event handler function such as is used in this module.<:p<* >> <:#1151,9360>The most important thing to note when using the mouse module is that the mouse event handler must be removed before exiting the program. It is a good idea to have an exit function (see the C <+!><+">atexit<-"><-!> function) and include the line <+!><+">x_mouse_remove<-"><-!>(); along with any other pre-exit cleanup code. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>SOURCES<:X11,-32768;TOC 2 "SOURCES"><-!> <:#286,9360> xmouse.asm <:s><:#286,9360> xlib.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:#286,9360> xmouse.h <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "EXPORTED VARIABLES">EXPORTED VARIABLES<-!> <:s><:#286,9360> <:#293,9360><+">MouseInstalled <-"> WORD - Indicates whether mouse handler installed <:s><:#286,9360> <:#293,9360><+">MouseHidden<-"> WORD - Indicates whether mouse cursor is hidden <:s><:#286,9360> <:#293,9360><+">MouseButtonStatus<-"> WORD - Holds the mouse button status <:s><:#286,9360> <:#293,9360><+">MouseX<-"> WORD - Current X position of mouse cursor <:s><:#286,9360> <:#293,9360><+">MouseY<-"> WORD - Current Y position of mouse cursor <:s><:#286,9360> <:#293,9360><+">MouseFrozen<-"> WORD - Disallows position updates if TRUE <:s><:#286,9360> <:#293,9360><+">MouseColor<-"> BYTE - The mouse cursors color <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!><:X11,-32768;TOC 2 "EXPORTED FUNCTIONS">EXPORTED FUNCTIONS<-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_mouse_init<:X11,-32768;TOC 3 "x_mouse_init"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype<-!>: int x_mouse_init() <:s><:#286,9360> <:s><:#858,9360>Initialize the mouse driver functions and install the mouse event handler function. This is the first function you must call before using any of the mouse functions. This mouse code uses the fastest possible techniques to save and restore mouse backgrounds and to draw the mouse cursor. <:s><:#286,9360> <:#579,9360><+!>WARNING:<-!> This function uses and updates <+">NonVisual_Offset<-"> to allocate video ram for the saved mouse background. <:s><:#286,9360> <:s><:#586,9360><+!>LIMITATIONS:<-!> No clipping is supported horizontally for the mouse cursor. No validity checking is performed for <+">NonVisual_Offs<-"> <:s><:#286,9360> <:#2030,9360><+!>**WARNING**<-!> You must Hide or at least Freeze the mouse cursor while drawing using any of the other XLIB modules since the mouse handler may modify VGA register settings at any time. VGA register settings are not preserved which will result in unpre dictable drawing behavior. If you know the drawing will occur away from the mouse cursor set <+">MouseFrozen<-"> to TRUE (1), do your drawing then set it to FALSE (0). Alternatively call <+!><+">x_hide_mouse<-"><-!>, perform your drawing and then call <+!><+">x_show_mouse<-"><-!>. Another alternative is to disable interrupts while drawing but usually drawing takes up a lot of time and having interrupts disabled for too long is not a good <:s><:#286,9360>idea. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_define_mouse_cursor">x_define_mouse_cursor<-"><-!><:f> <:#293,9360><+!>C Prototype:<-!> void x_define_mouse_cursor( char far *MouseDef, unsigned char MouseColor) <:s><:#286,9360> <:#293,9360><+">MouseDef<-"> - A far pointer to 14 characters containing a bitmask for all the cursor's rows. <:s><:#286,9360> <:s><:#293,9360><+">MouseColor<-"> - The color to use when drawing the mouse cursor. <:s><:#286,9360> <:#572,9360>Define a mouse cursor shape for use in subsequent cursor redraws. XMOUSE has a hardwired mouse cursor size of 8 pixels across by 14 pixels down. <:s><:#286,9360> <:s><:#293,9360><+!>WARNING<-!>: This function assumes<+#> <+">MouseDef<-#><-"> points to 14 bytes. <:s><:#286,9360> <:#586,9360><+!>Note: <-!><+#>Bit order is in reverse<-#>. i.e. bit 7 represents pixel 0, bit 0 represents pixel 7 in each byte of <+">MouseDef<-"> . <:s><:#286,9360> <:s><:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_show_mouse">x_show_mouse<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> void x_show_mouse(); <:s><:#286,9360> <:s><:#286,9360>Makes the cursor visible if it was previously hidden. <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> <+!><+">x_hide_mouse<-"><-!>. <:s><:#286,9360> <:s><:#286,9360> <:#333,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_hide_mouse">x_hide_mouse<-"> <-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> void x_hide_mouse(); <:s><:#286,9360> <:s><:#286,9360>Makes the cursor hidden if it was previously visible. <:s><:#286,9360> <:s><:#293,9360><+!>See Also:<-!> <+!><+">x_show_mouse<-"><-!>. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_mouse_remove<:X11,-32768;TOC 3 "x_mouse_remove"> <-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> void x_mouse_remove(); <:s><:#286,9360> <:s><:#286,9360>Stop mouse event handling and remove the mouse handler. <:s><:#286,9360> <:s><:#579,9360><+!>NOTE: <-!>This function <+#>MUST<-#> be called before quitting the program if a mouse handler has been installed <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_position_mouse">x_position_mouse<-"><-!><:f> <:#293,9360><+!>C Prototype: <-!> void x_position_mouse( int x, int y); <:s><:#286,9360> <:s><:#293,9360><+">x, y<-"> - Coordinates to move the mouse cursor to. <:s><:#286,9360> <:s><:#286,9360>Positions the mouse cursor at the specified location <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_mouse_window">x_mouse_window<-"><-!><:f> <:#293,9360><+!>C Prototype<-!>: void x_mouse_window( int x0, int y0, int x1, int y1); <:s><:#286,9360> <:s><:#293,9360><+">x0, y0<-"> - Coordinates of the upper left corner of the window. <:s><:#286,9360> <:s><:#293,9360><+">x1, y1<-"> - Coordinates of the lower right corner of the window. <:s><:#286,9360> <:s>Defines a mouse window. The mouse cursor is unable to move from this window.<:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_update_mouse<:X11,-32768;TOC 3 "x_update_mouse"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> void x_update_mouse(); <:s><:#286,9360> <:s><:#286,9360>Forces the mouse position to be updated and cursor to be redrawn. <:s><:#286,9360> <:s><:#293,9360><+!>Note:<-!> This function is useful when you have set <+">MouseFrozen<-"> to true. <:s>Allows the cursor position to be updated manually rather than automatically by the installed handler.<:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XBMTOOLS<:X11,-32768;TOC 1 "MODULE XBMTOOLS"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360>This module implements a set of functions to convert between planar bitmaps and linear bitmaps. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>PLANAR BITMAPS<-!> <:s><:#286,9360> <:s><:#286,9360>Planar bitmaps as used by these functions have the following structure: <:s><:#286,9360> BYTE 0 The bitmap width in bytes (4 pixel groups) range 1..255 <:s><:#286,9360> BYTE 1 The bitmap height in rows range 1..255 <:s><:#286,9360> BYTE 2..n1 The plane 0 pixels width*height bytes <:s><:#286,9360> BYTE n1..n2 The plane 1 pixels width*height bytes <:s><:#286,9360> BYTE n2..n3 The plane 2 pixels width*height bytes <:s><:#286,9360> BYTE n3..n4 The plane 3 pixels width*height bytes <:s><:#293,9360>as used by <+!><+">x_put_pbm, x_get_pbm, x_put_masked_pbm<-"><-!>. <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360><+!>LINEAR BITMAPS<-!> <:s><:#286,9360> <:s><:#286,9360>Linear bitmaps have the following structure: <:s><:#286,9360> BYTE 0 The bitmap width in pixels range 1..255 <:s><:#286,9360> BYTE 1 The bitmap height in rows range 1..255 <:s><:#286,9360> BYTE 2..n The width*height bytes of the bitmap <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "SOURCES">SOURCES<-!> <:#286,9360> xbmtools.asm <:#286,9360> xpbmtools.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:#286,9360> xbmtools.h <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!>MACROS<:X11,-32768;TOC 2 "MACROS"><-!> <:s><:#286,9360> <:#286,9360> BM_WIDTH_ERROR <:s><:#286,9360> <:#286,9360> LBMHeight( lbitmap) - Height of linear bitmap "lbitmap" <:s><:#286,9360> <:#286,9360> LBMWidth( lbitmap ) - Width of linear bitmap "lbitmap" <:s><:#286,9360> <:#286,9360> PBMHeight( pbitmap ) - Height of planar bitmap "pbitmap" <:s><:#286,9360> <:#286,9360> PBMWidth( pbitmap ) - Width of planar bitmap "pbitmap" <:s><:#286,9360> <:#286,9360> LBMPutPix( x, y, lbitmap, color) - Set the color of pixel (x, y) color in linear bitmap <:s><:#286,9360> <:#286,9360> LBMGetPix( x, y, lbitmap ) - Get the color of pixel (x, y) in linear bitmap <:s><:p<* >> <:#286,9360><+!><:X11,-32768;TOC 2 "EXPORT FUNCTIONS">EXPORT FUNCTIONS<-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_pbm_to_bm">x_pbm_to_bm<-"><-!><:f> <:#293,9360><+!>C Prototype:<-!> extern int x_pbm_to_bm( char far * source_pbm, char far * dest_bm); <:s><:#286,9360> <:s><:#293,9360><+">source_pbm<-"> - A pointer to the source planar bitmap. <:s><:#286,9360> <:s><:#293,9360><+">dest_bm<-"> - A pointer to a buffer set up to receive the linear bitmap. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> 0 on successful conversion. <:s><:#286,9360> <:s><:#579,9360>This function converts a bitmap in the planar format to the linear format as used by <+!><+">x_compile_bitmap<-"><-!>. <:s><:#286,9360> <:s><:#293,9360><+!>WARNING:<-!> The source and destination bitmaps <+#>must<-#> be pre-allocated. <:s><:#286,9360> <:s><:#579,9360><+!>NOTE:<-!> This function can only convert planar bitmaps that are suitable. If the source planar bitmap's width (per plane) is <;>= 256/4 it cannot be converted. In this situation an error code <:s><:#286,9360>BM_WIDTH_ERROR. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_bm_to_pbm<:X11,-32768;TOC 3 "x_bm_to_pbm"> <-"><-!><:f> <:#293,9360><+!>C Prototype<-!>: extern int x_bm_to_pbm( char far * source_lbm, char far * dest_bm); <:s><:#286,9360> <:s><:#293,9360><+">source_lbm <-"> - A pointer to the source linear bitmap. <:s><:#286,9360> <:s><:#293,9360><+">dest_bm <-">- A pointer to a buffer set up to receive the planar bitmap. <:s><:#286,9360> <:s><:#293,9360><+!>Returns: <-!>0 on successful conversion. <:s><:#286,9360> <:#572,9360>This function converts a bitmap in the linear format as used by x_compile_bitmap to the planar format. <:s><:#286,9360> <:s><:#293,9360><+!>WARNING:<-!> The source and destination bitmaps <+#>must<-#> be pre - allocated <:s><:#286,9360> <:s><:#579,9360><+!>NOTE: <-!>This function can only convert linear bitmaps that are suitable. If the source linear bitmap's width is not a multiple of 4 it cannot be converted. In this situation an error code <:s>BM_WIDTH_ERROR. <:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XCLIPPBM<:X11,-32768;TOC 1 "MODULE XCLIPPBM"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:#865,9360><+!>Note:<-!> VERY SIMILAR to XPBMCLIP. This module implements blits of clipped planar bitmaps. Blits are clipped to pixels, both horizontally. This makes the unmasked blit function here slightly slower than the equivalent functions in the XPBMCLIP module. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "SOURCES">SOURCES<-!> <:#286,9360> xclippbm.asm <:#286,9360> xclippbm.inc <:s><:#286,9360> xlib.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:#286,9360> xclippbm.h <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "EXPORTED VARIABLES">EXPORTED VARIABLES<-!> <:s><:#286,9360> <:#293,9360> <+">TopBound<-"> - int <:s><:#286,9360> <:#293,9360> <+">BottomBound<-"> - int <:s><:#286,9360> <:#293,9360><+"> LeftBound <-">- int <:s><:#286,9360> <+"> RightBound <-">- int<:p<* >> <:#286,9360><+!><:X11,-32768;TOC 2 "EXPORTED FUNCTIONS">EXPORTED FUNCTIONS<-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_clip_pbm">x_clip_pbm<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern int x_clip_pbm (int X, int Y, int ScreenOffs, char far * Bitmap); <:s><:#286,9360> <:s><:#293,9360><+">X, Y<-"> - The coordinates to place the bitmap at. <:s><:#286,9360> <:#293,9360><+">ScreenOffset<-"> - The offset of the page on which to draw the bitmap. <:s><:#286,9360> <:s><:#293,9360><+">Bitmap<-"> - A far pointer to the planar bitmap. <:s><:#286,9360> <:s><:#579,9360><+!>Returns: <-!> If the entire bitmap turns out to be outside the bounding box, this function returns a 1, otherwise it returns a 0 <:s><:#286,9360> <:s><:#286,9360>Copies a planar bitmap from SRAM to VRAM, with clipping. <:s><:#286,9360> <:s><:#286,9360>. <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_clip_masked_pbm<:X11,-32768;TOC 3 "x_clip_masked_pbm"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern int x_clip_masked_pbm (int X, int Y, int ScreenOffs, char far * Bitmap); <:s><:#286,9360> <:s><:#293,9360><+">X, Y<-"> - The coordinates to place the bitmap at. <:s><:#286,9360> <:s><:#293,9360><+">ScreenOffset<-"> - The offset of the page on which to draw the bitmap. <:s><:#286,9360> <:s><:#293,9360><+">Bitmap<-"> - A far pointer to the planar bitmap. <:s><:#286,9360> <:s><:#579,9360><+!>Returns: <-!>If the entire bitmap turns out to be outside the bounding box, this function returns a 1, otherwise it returns a 0 <:s><:#286,9360> <:s>Copies a planar bitmap from SRAM to VRAM, with clipping, 0 bytes in the bitmap are not copied. <:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XCIRCLE<:X11,-32768;TOC 1 "MODULE XCIRCLE"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:#286,9360>Mode X circle functions <:s><:#286,9360><+!> <:#286,9360><+!><:X11,-32768;TOC 2 "SOURCES">SOURCES<-!> <:#286,9360> xcircle.asm <:#286,9360> xcircle.inc <:s><:#286,9360> xlib.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> xcircle.h<:p<* >> <:#286,9360><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_circle">x_circle<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern void x_circle (WORD Left, WORD Top, WORD Diameter, <:s><:#286,9360> WORD Color, WORD ScreenOffs); <:s><:#286,9360> <:s><:#293,9360><+">Left, Top<-"> - The coordinates of the upper left corner of the circle, in pixels. <:s><:#286,9360> <:s><:#293,9360><+">Diameter <-">- The diameter of the circle. <:s><:#286,9360> <:s><:#293,9360><+">Color <-">- The color in which to draw the circle. <:s><:#286,9360> <:s><:#293,9360><+">ScreenOffs<-"> - The page offset to draw the circle on. <:s><:#286,9360> <:s><:#286,9360>Draws a circle with the given upper-left-hand corner and diameter, which are given in pixels. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_filled_circle">x_filled_circle<-"><-!><:f> <:s><:#293,9360><+!>C Prototype: <-!>extern void x_filled_circle (WORD Left, WORD Top, WORD Diameter, <:s><:#286,9360> WORD Color, WORD ScreenOffs); <:s><:#293,9360><+"> <:s><:#293,9360><+">Left, Top<-"> - The coordinates of the upper left corner of the circle, in pixels. <:s><:#286,9360> <:s><:#293,9360><+">Diameter <-">- The diameter of the circle. <:s><:#286,9360> <:s><:#293,9360><+">Color <-">- The color in which to draw the circle. <:s><:#286,9360> <:s><:#293,9360><+">ScreenOffs<-"> - The page offset to draw the circle on. <:s><:#286,9360> <:s><:#286,9360>Draws a filled circle with the given upper-left-hand corner and diameter. <:s><:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XDETECT<:X11,-32768;TOC 1 "MODULE XDETECT"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360>This module implements a set of functions to detect the PC's hardware configuration. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "SOURCES">SOURCES<-!> <:#286,9360> xdetect.asm <:#286,9360> xdetect.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:#286,9360> xdetect.h <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "EXPORTED MACROS">EXPORTED MACROS<-!> <:s><:#286,9360> I8086 0 <:s><:#286,9360> I80186 1 <:s><:#286,9360> I80286 2 <:s><:#286,9360> I80386 3 <:s><:#286,9360> <:#286,9360> NoGraphics 0 <:#286,9360> MDA 1 <:#286,9360> CGA 2 <:#286,9360> EGAMono 3 <:#286,9360> EGAColor 4 <:#286,9360> VGAMono 5 <:#286,9360> VGAColor 6 <:#286,9360> MCGAMono 7 <:#286,9360> MCGAColor 8 <:s><:#286,9360> <:#286,9360> BUS_MOUSE 1 <:#286,9360> SERIAL_MOUSE 2 <:#286,9360> INPORT_MOUSE 3 <:#286,9360> PS2_MOUSE 4 <:#286,9360> HP_MOUSE 5 <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!><:X11,-32768;TOC 2 "EXPORTED VARIABLES">EXPORTED VARIABLES<-!> <:s><:#286,9360> <:#293,9360><+">MouseButtonCount<-"> WORD - The number of buttons on the detected mouse <:s><:#286,9360> <:#293,9360><+">MouseVersion<-"> WORD - Mouse driver version <:s><:#286,9360> (High byte = Major version, Low byte = minor version) <:s><:#286,9360> <:#293,9360><+">MouseType<-"> BYTE - The mouse type <:s><:#286,9360> <:#293,9360><+">MouseIRQ <-"> BYTE - The IRQ number used by the mouse driver <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_graphics_card">x_graphics_card<-"><-!><:f> <:s><:#293,9360><+!>C Prototype<-!>: extern int x_graphics_card(); <:s><:#286,9360> <:s><:#293,9360><+!>Returns: <-!>The type of graphics card installed. <:s><:#286,9360> <:s><:#286,9360>See the defines for this module. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_processor">x_processor<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern int x_processor(); <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The type of processor installed. <:s><:#286,9360> <:s><:#293,9360><+!>Note: <-!>A 486 registers as a 386. <:s><:#286,9360> <:s><:#286,9360>See defines for this module. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+"><+!><:X11,-32768;TOC 3 "x_coprocessor">x_coprocessor<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern int x_coprocessor(); <:s><:#286,9360> <:s><:#293,9360><+!>Returns: <-!>1 of a numeric co-processor is present, 0 if not. <:s><:#286,9360> <:#579,9360><+!>Note:<-!> The type is not detected but it's not really necessary as the processor type usually determines the numeric coprocessor type <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_mousedriver">x_mousedriver<-"><-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern int x_mousedriver(); <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> 1 of a mouse driver is installed, 0 otherwise. <:s><:#286,9360> <:s><:#286,9360>If a mouse driver is detected the mouse related variables are set accordingly. <:s><:#286,9360> <:s><:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XFILEIO<:X11,-32768;TOC 1 "MODULE XFILEIO"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360>Handle based file I/O functions. <:s><:#286,9360>See any good DOS programming reference for more information on int 21h DOS services. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "SOURCES">SOURCES<-!> <:#286,9360> xfileio.asm <:#286,9360> xfileio.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:#286,9360> xfileio.h <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "EXPORTED MACROS">EXPORTED MACROS<-!> <:s><:#286,9360><+!> File access modes<-!> <:#286,9360> F_RDONLY - Read only. <:#286,9360> F_WRONLY - Write only. <:#286,9360> F_RDWR - Read and write <:s><:#286,9360> <:s><:#286,9360><+!> Seek codes<-!> <:#286,9360> SEEK_START - Bytes from the start of the file. <:#286,9360> SEEK_CURR - Bytes from the current position. <:#286,9360> SEEK_END - Bytes from the end of the file. <:s><:#286,9360> <:s><:#286,9360><+!> File error value<-!> FILE_ERR<:p<* >> <:#286,9360><+!><:X11,-32768;TOC 2 "EXPORTED FUNCTIONS">EXPORTED FUNCTIONS<-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">f_open<:X11,-32768;TOC 3 "f_open"><-"><-!><:f> <:#293,9360><+!>C Prototype: <-!>extern int f_open(char * filename, char access); <:s><:#286,9360> <:s><:#293,9360><+">filename<-"> - A pointer to a string containing the full path and filename you wish to open. <:s><:#286,9360> <:s><:#293,9360><+">access<-"> - A character that defines the access mode. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The file handle on success, FILE_ERR on failure. <:s><:#286,9360> <:s><:#286,9360>Opens a file according to the access char. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "f_close">f_close<-"><-!><:f> <:#293,9360><+!>C Prototype: <-!> extern int f_close(int handle); <:s><:#286,9360> <:s><:#293,9360><+">handle<-"> - The handle of the file you wish to close. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> 0 on success, FILE_ERR on failure. <:s><:#286,9360> <:s><:#286,9360>Closes the file associated with the specified handle. <:s><:#286,9360> <:s><:#286,9360> <:#333,9360><:f280, Times New Roman,0,0,0><+!><+">f_read<:X11,-32768;TOC 3 "f_read"><-"> <-!><:f> <:#293,9360><+!>C Prototype: <-!> extern int f_read(int handle,char near * buffer, int count); <:s><:#286,9360> <:s><:#293,9360><+">handle<-"> - The handle of the file you wish to read from. <:s><:#286,9360> <:s><:#293,9360><+">buffer<-"> - A near pointer to a buffer to receive the bytes from the file. <:s><:#286,9360> <:s><:#293,9360><+">count<-"> - The number of bytes to read from the file. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The number of bytes read on success, FILE_ERR on failure <:s><:#286,9360> <:s><:#286,9360>Reads bytes from the a file into a near buffer <:s><:#286,9360> <:s><:p<* >> <:#333,9360><:f280, Times New Roman,0,0,0><+!><+">f_readfar<:X11,-32768;TOC 3 "f_readfar"><-"> <-!><:f> <:#293,9360><+!>C Prototype: <-!> extern int f_readfar(int handle,char far * buffer, int count); <:s><:#286,9360> <:s><:#293,9360><+">handle<-"> - The handle of the file you wish to read from. <:s><:#286,9360> <:s><:#293,9360><+">buffer<-"> - A far pointer to a buffer set up to receive the data. <:s><:#286,9360> <:s><:#293,9360><+">count <-">- The number of bytes to read. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The number of bytes read on success, FILE_ERR on failure <:s><:#286,9360> <:s><:#286,9360>Reads a block of bytes a file into a far buffer. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "f_write">f_write<-"><-!><:f> <:#293,9360><+!>C Prototype:<-!> extern int f_write(int handle, char near * buffer, int count); <:s><:#286,9360> <:s><:#293,9360><+">handle<-"> - The handle of the file you wish to write to. <:s><:#286,9360> <:s><:#293,9360><+">buffer<-"> - A near pointer to a buffer containing the data to write. <:s><:#286,9360> <:s><:#293,9360><+">count <-">- The number of bytes to write. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The number of bytes written on success, FILE_ERR on failure <:s><:#286,9360> <:s><:#286,9360>Writes a block bytes to a file from a near buffer <:s><:#286,9360> <:s><:#286,9360> <:#333,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "f_writefar">f_writefar<-"> <-!><:f> <:s><:#293,9360><+!>C Prototype:<-!> extern int f_write(int handle, char far * buffer, int count); <:s><:#286,9360> <:s><:#293,9360><+">handle<-"> - The handle of the file you wish to write to. <:s><:#286,9360> <:s><:#293,9360><+">buffer<-"> - A far pointer to a buffer containing the data to write. <:s><:#286,9360> <:s><:#293,9360><+">count <-">- The number of bytes to write. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The number of bytes written on success, FILE_ERR on failure <:s><:#286,9360> <:s><:#286,9360>Writes a block of bytes to a file from a far buffer. <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">f_seek<:X11,-32768;TOC 3 "f_seek"> <-"><-!><:f> <:#293,9360><+!>C Prototype:<-!> extern long int f_seek(int handle, long int position, char method_code) <:s><:#286,9360> <:s><:#293,9360><+">handle<-"> - The handle of the file you are working with. <:s><:#286,9360> <:s><:#293,9360><+">position<-"> - The position to move to. <:s><:#286,9360> <:s><:#293,9360><+">method_code<-"> - The seek method you wish to use. (See the defines.) <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The file pointer position on success, FILE_ERR on failure. <:s><:#286,9360> <:s><:#286,9360>Moves the file pointer. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">f_filelength<:X11,-32768;TOC 3 "f_filelength"> <-"><-!><:f> <:#293,9360><+!>C Prototype:<-!> extern long int f_filelength(int handle) <:s><:#286,9360> <:s><:#293,9360><+">handle<-"> - The handle of the file you are working with. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The length of the file on success, FILE_ERR on failure. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">f_tell<:X11,-32768;TOC 3 "f_tell"><-"><-!><:f> <:#293,9360><+!>C Prototype:<-!> extern long int f_tell(int handle) <:s><:#286,9360> <:s><:#293,9360><+">handle<-"> - The handle of the file you are working with. <:s><:#286,9360> <:s><+!>Returns:<-!> The file pointer position on success, FILE_ERR on failure<:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XRLETOOL<:X11,-32768;TOC 1 "MODULE XRLETOOL"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360>This module implements a number of functions comprising an RLE encoding decoding system. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "SOURCES">SOURCES<-!> <:#286,9360> xrletool.asm <:#286,9360> xrletool.inc <:s><:#286,9360> model.inc <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:#286,9360> xrletool.h <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_buff_RLDecode">x_buff_RLDecode<-"><-!><:f> <:#293,9360><+!>C prototype<-!>: extern unsigned int x_buff_RLDecode(char far * source_buff, char far *dest_buff); <:s><:#286,9360> <:s><:#293,9360><+">source_buff<-"> - A far pointer to the buffer to compress <:s><:#286,9360> <:#293,9360><+">dest_buff<-"> - A far pointer to the destination buffer <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The size of the resultant uncompressed data. <:s><:#286,9360> <:s><:#286,9360>Expands an RLE compressed source buffer to a destination buffer. <:s><:#286,9360> <:s><:#293,9360><+!>WARNING: <-!>The buffers <+#>must<-#> be pre-allocated. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_buff_RLEncode">x_buff_RLEncode<-"><-!><:f> <:#293,9360><+!>C prototype<-!>: extern unsigned int x_buff_RLEncode( char far * source_buff, char far *dest_buff, <:s><:#286,9360> unsigned int count); <:s><:#286,9360> <:s><:#293,9360><+">source_buff <-"> - A far pointer to the buffer to compress. <:s><:#286,9360> <:s><:#293,9360><+">dest_buff<-"> - A far pointer to the destination buffer. <:s><:#286,9360> <:s><:#293,9360><+">count <-">- The size of the source data in bytes. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The size of the resultant compressed data. <:s><:#286,9360> <:s><:#286,9360>RLE Compresses a source buffer to a destination buffer. <:s><:#286,9360><+!> <:s><:#293,9360><+!>WARNING:<-!> The buffers <+#>must<-#> be pre allocated. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_buff_RLE_size<:X11,-32768;TOC 3 "x_buff_RLE_size"> <-"><-!><:f> <:#293,9360><+!>C prototype:<-!> extern unsigned int x_buff_RLE_size( char far * source_buff, unsigned int count); <:s><:#286,9360> <:s><:#293,9360><+">source_buff <-"> - A far pointer to the uncompressed data buffer <:s><:#286,9360> <:s><:#293,9360><+">count <-"> - The size of the source data in bytes <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The size the input data would compress to. <:s><:#286,9360> <:s><:#286,9360> <:#333,9360><:f280, Times New Roman,0,0,0><+!><+">x_file_RLEncode<:X11,-32768;TOC 3 "x_file_RLEncode"><-"> <-!><:f> <:#293,9360><+!>C prototype:<-!> extern unsigned int x_file_RLEncode( int handle, char far * source_buff, <:s><:#286,9360> unsigned int count); <:s><:#286,9360> <:s><:#293,9360><+">source_buff <-"> - A far pointer to the buffer to compress <:s><:#286,9360> <:s><:#293,9360><+">handle<-"> - The output file handle. <:s><:#286,9360> <:s><:#293,9360><+">count<-"> - The size of the source data in bytes <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The size of the resultant compressed data or 0 if it fails. <:s><:#286,9360> <:s><:#286,9360>RLE Compresses a source buffer to an output file. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_file_RLDecode">x_file_RLDecode<-"><-!><:f> <:#293,9360><+!>C prototype:<-!> extern unsigned int x_buff_RLDecode( int handle, char far * dest_buff); <:s><:#293,9360><+"> <:s><:#293,9360><+">handle<-"> - Input file handle <:s><:#286,9360> <:s><:#293,9360><+">dest_buff <-"> - A far pointer to the destination buffer <:s><:#286,9360> <:s><:#293,9360><+!>Returns: <-!>The size of the resultant uncompressed data. <:s><:#286,9360> <:s><:#286,9360>Expands an RLE compresses file to a destination RAM buffer. <:s><:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>MODULE XPOLYGON<:X11,-32768;TOC 1 "MODULE XPOLYGON"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360>This module implements general filled convex polygon and triangle functions <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "SOURCES">SOURCES<-!> <:#293,9360><+!> <-!>xpolygon.asm <:#286,9360> xpolygon.inc <:s><:#286,9360><+!> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:#286,9360> xpolygon.h <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "TYPE DEFS">TYPE DEFS<-!> <:#286,9360> typedef struct { int X; int Y; } far VERTEX; <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!><:X11,-32768;TOC 2 "EXPORTED FUNCTIONS">EXPORTED FUNCTIONS<-!> <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_triangle<:X11,-32768;TOC 3 "x_triangle"><-"><-!><:f> <:#293,9360><+!>C Prototype:<-!> void x_triangle( int x0, int y0, int x1, int y1, int x2, int y2, WORD color, <:s><:#286,9360> WORD PageBase); <:s><:#286,9360> <:s><:#293,9360><+">x0, y0<-"> - The coordinates of point one of the triangle. <:s><:#286,9360> <:s><:#293,9360><+">x1, y1<-"> - The coordinates of point two of the triangle. <:s><:#286,9360> <:s><:#286,9360>x2, y2 - The coordinates of the third (and final) point of the triangle. <:s><:#286,9360> <:s><:#293,9360><+">color<-"> - The color in which to draw the triangle in. <:s><:#286,9360> <:s><:#293,9360><+">PageBase<-"> - The page offset on which to draw the triangle. <:s><:#286,9360> <:#579,9360>This function draws a filled triangle which is clipped to the current clipping window defined by <+">TopClip, BottomClip, LeftClip, RightClip<-">. <:s><:#286,9360> <:s><:#579,9360><+!>Remember: <-!><+#>The X clipping variable are in BYTES not PIXELS<-#> so you can only clip to 4 pixel byte boundaries. <:s><:#286,9360> <:s><:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_polygon">x_polygon<-"><-!><:f> <:#293,9360><+!>C Prototype:<-!> void x_polygon( VERTEX *vertices, int num_vertices, WORD color, <:s><:#286,9360> WORD PageBase); <:s><:#293,9360><+"> <:#293,9360><+">vertices<-"> - A pointer to your vertex structure. <:s><:#286,9360> <:s><:#293,9360><+">num_vertices<-"> - The number of vertices to plot. <:s><:#286,9360> <:s><:#293,9360><+">color<-"> - The color in which to draw the polygon. <:s><:#286,9360> <:s><:#293,9360><+">PageBase<-"> - The page offset on which to draw the polygon. <:s><:#286,9360> <:s><:#572,9360>This function is similar to the triangle function but draws convex polygons. The vertices are supplied in the form of a FAR pointer. <:s><:#286,9360> <:s><:#579,9360><+!>NOTE:<-!> A convex polygon is one such that if you draw a line from any two vertices, every point on that line will be within the polygon. <:s><:#286,9360> <+@>This function works by splitting up a polygon into its component triangles and calling the triangle routine above to draw each one. Performance is respectable but a custom polygon routine might be faster.<:p<* >><:f280,2Times New Roman,0,0,0><+!>MODULE XBEZ <-!><:f><+!><:f280,2Times New Roman,0,0,0>IER<-!><:f><:X11,-32768;TOC 1 "MODULE XBEZIER"> <+@><:s><:#286,9360> <+@><:#286,9360>Bezier curve plotting function. See "What is a Bezier curve?" for more details. <+@><:s><:#286,9360> <+@><:s><:#286,9360> <+@><:#286,9360><+!><:X11,-32768;TOC 2 "SOURCES">SOURCES<-!> <:#286,9360> xbezier.asm <:s><:#286,9360> xlib.inc <:s><:#286,9360> <:s><:#286,9360><+!> <:#286,9360><+!>C HEADER FILE<:X11,-32768;TOC 2 "C HEADER FILE"><-!> <+!> <-!>xbezier.h<:p<* >> <:#286,9360><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!> <:s><:#286,9360><+!> <:s><:#286,9360><+!> <:#326,9360><+!><:f280, Times New Roman,0,0,0><+">x_bezier<:X11,-32768;TOC 3 "x_bezier"><-"> <:#293,9360><+!>C Prototype:<-!> void x_bezier( int e1x, int e1y, int c1x, int c1y, int c2x, int c2y, <:#286,9360> int e2x, int e2y, int levels, char color, WORD PageBase); <:s><:#286,9360> <:s><:#293,9360><+">e1x, e1y, e2x, e2y<-"> - The coordinates of the two endpoints. <:s><:#286,9360> <:s><:#293,9360><+">c1x, c1y, c2x, c2y<-"> - The coordinates of the two control points. <:s><:#286,9360> <:s><:#293,9360><+">levels<-"> - <:s><:#286,9360> <:s><:#293,9360><+">color<-"> - The color to draw with. <:s><:#286,9360> <:s><:#293,9360><+">PageBase<-"> - The page offset on which to draw. <:s><:#286,9360> <:s><:#286,9360>Plots a Bezier curve on the screen. <:s><:#286,9360> <:s><:#293,9360><+!>See also: <-!>"What is a Bezier curve?" <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360><+!> <:s><:#286,9360><+!> <+B><:p<* >><:f280, Times New Roman,0,0,0><+!>MODULE XFILL<:X11,-32768;TOC 1 "MODULE XFILL"> <+@><:s><:#333,9360><+!><:f280, Times New Roman,0,0,0> <:s><:#286,9360>This module implements a couple of general purpose flood fill functions. <:s><:#286,9360> <:s><:#286,9360><+!> <:#286,9360><+!><:X11,-32768;TOC 2 "SOURCES">SOURCES <:#286,9360> xfill.asm <:s><:#286,9360> xlib.inc <:s><:#286,9360> <:#286,9360><+!>C HEADER FILE<:X11,-32768;TOC 2 "C HEADER FILE"> xfill.h<:p<* >> <:#286,9360><-!><+!><:X11,-32768;TOC 2 "EXPORTED FUNCTIONS">EXPORTED FUNCTIONS <:s><:#286,9360><+!> <:s><:#286,9360><+!> <:#326,9360><:f280, Times New Roman,0,0,0><+"><+!>x_flood_fill<-!><-"><:X11,-32768;TOC 3 "x_flood_fill"> <:#293,9360><+!>C Prototype: <-!>int x_flood_fill( int x, int y, WORD offs, int boundary, int color); <:s><:#286,9360> <:s><:#293,9360><+">x, y <-">- The starting coordinates. <:s><:#286,9360> <:s><:#293,9360><+">offs<-"> - The page offset to draw on. <:s><:#286,9360> <:#293,9360><+">boundary - Boundary<-"><+"> color. <:s><:#286,9360> <:s><:#293,9360><+">color<-"> - The color to use for the fill. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The number of pixels that were filled. <:s><:#286,9360> <:#1151,9360>This function performs the familiar flood filling used by many paint programs and, of course, the Borland BGI's flood fill function. The pixel at <+">x, y<-"><+"> <-"> and all adjacent pixels of the same color are filled with the new color. Filling stops when there are no more adjacent pixels of the original pixels color. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_boundry_fill">x_boundry_fill<-"><-!> <:#293,9360><+!>C Prototype: <-!>int x_boundry_fill( int x, int y, WORD offs, int boundary, int color); <:s><:#286,9360> <:s><:#293,9360><+">x, y <-">- The starting coordinates. <:s><:#286,9360> <:s><:#293,9360><+">offs<-"> - The page offset to draw on. <:s><:#286,9360> <:#293,9360><+">boundary - Boundary color. <:s><:#286,9360> <:s><:#293,9360><+">color<-"> - The color to use for the fill. <:s><:#286,9360> <:s><:#293,9360><+!>Returns:<-!> The number of pixels that were filled. <:s><:#286,9360> <:#872,9360>This function performs a variant of the flood fill described above. The pixel at <+">x, y<-"><+"> <-"> and all adjacent pixels of the same color are filled with the new color. Filling stops when the area being filled is fully enclosed by pixels of the color <+">boundary. <:s><:#326,9360><+!><+"><:f280, Times New Roman,0,0,0> <+B><:p<* >><:f280, Times New Roman,0,0,0><+!>MODULE XVSYNC<:X11,-32768;TOC 1 "MODULE XVSYNC"><-!><:f> <+@><:s><:#286,9360> <:#286,9360>Inspired by REND386 v3.01 by Dave Stamps and Bernie Roehl <:s><:#286,9360> <:#1430,9360>This module uses timer 0 to simulate a vertical retrace interrupt. It's designed to significantly reduce the idle waiting time in XLIB. Why simulate the VRT interrupt? Simply because a true VRT interrupt is not implemented on many VGA cards. Using a VRT interrupt as opposed to polling, can result in huge performance improvements for your code and help make animation much smoother than it would be using polling. <:s><:#286,9360> <:#1158,9360>Normally XLIB waits for vsync when <+!><+">x_page_flip, x_set_start_address<-!><-"> or <+!><+">x_put_pal_???<-!><-"> is called. the waiting period could be better utilized to do housekeeping calculations or whatever. The <+!><+">x_put_pal_???<-!><-"> functions also don't work very smoothly in conjunction with other functions that wait for the vertical retrace since each function introduces its own VRT delay. <:s><:#286,9360> <:#572,9360>When using the vsync handler, the VRT delay is reduced to the absolute minimum which can result in a huge performance boost for your programs. <:s><:#286,9360> <:s><:#572,9360>When using double buffering, you may still have to wait before drawing, but you could do as much other work as possible, like this: <:s><:#286,9360> <:s><:#280,9360> <:f240,2MS Serif,0,0,0>x_page_flip(...); <:s><:#280,9360><:f240,2MS Serif,0,0,0> <:f><:f240,2MS Serif,0,0,0>/* animate the palette */ <:s><:#280,9360><:f240,2MS Serif,0,0,0> /* <:f><:f240,2MS Serif,0,0,0>do some collision detection and 3D calculations */ <:s><:#280,9360><:f240,2MS Serif,0,0,0> /* read the joystick */ <:#280,9360><:f240,2MS Serif,0,0,0> <:f><:f240,2MS Serif,0,0,0>x_wait_start_address(); /* Not needed with triple buffering. *<:f><:f240,2MS Serif,0,0,0>/ <:s><:#280,9360><:f240,2MS Serif,0,0,0> /* draw the next frame. */ <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "SOURCES">SOURCES<-!> <:#286,9360> xvsync.asm <:s><:#286,9360> xmain.asm <:#286,9360> xvsync.inc <:s><:#286,9360> xmain.inc <:s><:#286,9360> <:s><:#286,9360><+!> <:#286,9360><+!><:X11,-32768;TOC 2 "C HEADER FILE">C HEADER FILE<-!> <:#293,9360><+!> <-!>xvsync.h <:s><:p<* >> <:#286,9360><+!><:X11,-32768;TOC 2 "EXPORTED VARIABLES">EXPORTED VARIABLES<-!> <:s><:#286,9360><+!> <:#293,9360><+">VsyncPeriod<-"> WORD - Time in 1.193 between two vsyncs. <:s><:#286,9360> <:#293,9360><+">TicksPerSecond<-"> WORD - Number of vsyncs per second. <:s><:#286,9360> <:#293,9360><+">VsyncTimerInt<-"> long - Number of vsyncs since <+!><+">x_install_vsync_handler<-!><-"> was called. Nice for<-"> <:s> game timing.<:p<* >> <:#286,9360><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"><-!> <:s><:#286,9360><+!> <:s><:#286,9360><+!> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_install_vsync_handler<:X11,-32768;TOC 3 "x_install_vsync_handler"><-"><-!> <:#293,9360><+!>C Prototype:<-!> void x_install_vsync_handler( int VRTsToSkip); <:s><:#286,9360> <:#293,9360><+">VRTsToSkip<-"> - Defines the delay in VRT's between consecutive physical start address changes, <:s><:#286,9360> thus allowing you to limit the maximum frame rate for page flips in animation <+A><:s><:#293,9360> systems. The frame rate is calculated as Vertical Refresh Rate / <+">VRTsToSkip.<-"> <:#293,9360><+"> <-">Thus in the 320x240 mode which refreshes at 60Hz a <+">VRTsToSkip<-"> value of <:#286,9360> 3 will result in a maximum page flipping rate of 20Hz (Frames per second). <:s><:#286,9360> <:s><:#286,9360>This function installs the vsync handler using timer 0. It's called about 100 microseconds before <:s><:#286,9360>every vertical retrace. <:s><:#286,9360> <:s><:#293,9360><+!>WARNING<-!><+!>:<-!> Be sure to remove it before exiting your program. <:s><:#286,9360> When used with a debugger, the system clock may speed up. <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+">x_remove_vsync_handler<:X11,-32768;TOC 3 "x_remove_vsync_handler"><-"><-!> <:s><:#293,9360><+!>C Prototype: <-!>void x_remove_vsync_handler( void ); <:s><:#286,9360> <:s><:#286,9360>This function removes the vsync handler. <:s><:#286,9360> <:s><:#286,9360>You <+#>must<-#> call this function before exiting your program, or your system will crash! <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><:X11,-32768;TOC 3 "x_set_user_vsync_handler">x_set_user_vsync_handler<-"><-!> <:s><:#293,9360><-"><+!>C Prototype: <-!>void x_set_user_vsync_handler( void far (*f)() ); <:s><:#286,9360> <:s><:#293,9360><+">f<-"> - A far pointer to a user function to be called once each vertical retrace. <:s><:#286,9360> <:#572,9360>This function installs a user routine to be called once each vertical retrace. The user handler has its own stack of 256 bytes, so be careful with the stack checking option in BC. <:s><:#286,9360> <:s><:#293,9360><+!>WARNING:<-!> This installs an interrupt driven handler, beware of the following: @Bullet 1@<:s><:#286,9360>Only 8086 registers are preserved. If you're using 386 code, save all the 386 registers. @Bullet 1@<:s><:#286,9360>Don't do any drawing. @Bullet 1@<:s><:#286,9360>Don't call any DOS functions. <:s><:#286,9360> <:s>You CAN update global variables if you're careful. And it's nice for palette animation. You can even do fades while loading from disk. You should usee this instead of installing your own int 08h routine and chaining to the original.<:p<* >> <:#326,9360><:f280, Times New Roman,0,0,0><+!><+"><-#>x_wait_start_addr<:X11,-32768;TOC 3 "x_wait_start_addr"><-"><-!> <:s><:#293,9360><+!>C Prototype: <-!>void x_wait_start_addr( void ); <:s><:#286,9360> <:s><:#579,9360>You must call this function before drawing after a call to <+!><+">x_set_start_addr<-!><-"> or <+!><+">x_page_flip<-!><-"> when you are using the vsync handler and not using triple buffering.<-"><-"> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360><+!> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <+B><:f240,2MS Serif,0,0,0> <:f><-"><-"><-"><:p<* >><:f280, Times New Roman,0,0,0><+!>MODULE XCBITM32<:X11,-32768;TOC 1 "MODULE XCBITM32"> <+@><:s><:#333,9360><+!><:f280, Times New Roman,0,0,0> <:#579,9360>This module implements 32 bit compiling of linear bitmaps. There are no functions for plotting the compiled bitmaps in this module, use <+!><+">x_put_cbitmap<-!><-"> for that. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>SOURCES<:X11,-32768;TOC 2 "SOURCES"> <:#293,9360><+!> <-!>xcbitm32.c <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>C HEADER FILE<:X11,-32768;TOC 2 "C HEADER FILE"> <:#293,9360><+!> <-!><-">xcbitm32.h <:s><:p<* >> <:#286,9360><+!>EXPORTED FUNCTIONS<:X11,-32768;TOC 2 "EXPORTED FUNCTIONS"> <:s><:#286,9360><+!> <:s><:#286,9360><+!> <:#326,9360><+!><+"><:f280, Times New Roman,0,0,0>x_compile_bitmap_32<:X11,-32768;TOC 3 "x_compile_bitmap_32"><-"><-!><:f> <:s><:#293,9360><+!>C Prototype: <-!> x_compile_bitmap_32( WORD lsw, char far *bitmap, char far *output ); <:s><:#286,9360> <:s><:#293,9360><+">lsw<-"> - The logical screen width in bytes. <:s><:#286,9360> <:s><:#293,9360><+">bitmap<-"> - A pointer to the source linear bitmap. <:s><:#286,9360> <:s><:#293,9360><+">output<-"> - A far pointer to a buffer set up to receive the compiled bitmap. <:s><:#286,9360> <:s><:#293,9360><+!>Returns: <-!>The size of the compiled bitmap in bytes. <:s><:#286,9360> <:s><:#572,9360>Compiles a linear bitmap to generate 386+ machine code to plot it at any required screen coordinates FAST! <:s><:#286,9360> <:s><:#286,9360> <:#326,9360><+!><+"><:f280, Times New Roman,0,0,0>x_sizeof_cbitmap_32<:X11,-32768;TOC 3 "x_sizeof_cpbm"> <:#293,9360><:f><-"><+!>C Prototype: <-!> int x_sizeof_cbitmap32( WORD lsw, char far *bitmap ); <:s><:#286,9360> <:s><:#293,9360><+">lsw<-"> - The logical screen width in bytes. <:s><:#286,9360> <:s><:#293,9360><+">bitmap<-"> - A far pointer to the source linear bitmap. <:s><:#286,9360> <:s><:#293,9360><+!>Returns: <-!> The space in bytes required to hold the compiled bitmap. <+B><:s><:p<* >> <+B><:#333,9360><:f280,2Times New Roman,0,0,0><+!>REFERENCE SECTION<:X11,-32768;TOC 1 "REFERENCE SECTION"><-!><:f> <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "REFERENCES">REFERENCES<-!> <:s><:#286,9360>In my opinion <+#>Doctor Dobbs Journal<-#> is the best reference text for VGA Mode X graphics: <:#286,9360> Issue 178 Jul. 1991 : First reference to Mode X Article Abstract : VGA's undocumented <:s><:#286,9360> Mode X supports page flipping, makes off screen memory available, <:s><:#286,9360> has square pixels, and increases performance by as much as 4 times. <:s><:#286,9360> <:#286,9360> Issue 179 Aug. 1991 : Continuation Article Abstract. Michael discusses latches and <:#286,9360> VGA's undocumented Mode X. <:s><:#286,9360> <:#286,9360> Issue 181 Sept. 1991 : Continuation Article Abstract. Michael puts the moves on <:#286,9360> animation using VGA's 256 colors. <:s><:#286,9360> <:#286,9360> Issue 184 Oct. 1991 : First of a continuing series covering 3-D animation using VGA's <:s><:#286,9360> Mode X. This series is still ongoing <:s><:#286,9360> <:s><:#286,9360> (October 1992) Article Abstract. Michael moves into 3-D animation, starting with basic <:s><:#286,9360> polygon fills and page flips. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "WHAT IS MODE X ?">WHAT IS MODE X ?<-!> <:#2002,9360>Mode X is a derivative of the VGA's standard mode 13h (320x200 256 color). It is a (family) of undocumented video modes that are created by tweaking the VGA's registers. The beauty of mode X is that it offers several benefits to the programmer: - Multiple g raphic pages where mode 13h doesn't allowing for page flipping (also known as double buffering) and storage of images and data in offscreen video memory - A planar video ram organization which although more difficult to program, allows the VGA's plane-orie nted hardware to be used to process pixels in parallel, improving performance by up to 4 times over mode 13h <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!><:X11,-32768;TOC 2 "WHAT IS A SPLIT SCREEN ?">WHAT IS A SPLIT SCREEN ?<-!> <:#858,9360>A split screen is a hardware feature offered by the EGA and VGA video cards. A split screen is a mode of graphics operation in which the hardware splits the visual graphics screen horizontally and treats both halves as individual screens each starting at di fferent locations in video RAM. <:s><:#572,9360>The bottom half (which is usually referred to as the split screen) always starts at address A000:0000 but the top half's starting address is user definable. <:s>The most common application of split screens in games is the status display in scrolling games. Split screens make this sort of game simpler to program because when the top half window is scrolled the programmer does not have to worry about redrawing the bo ttom half.<:p<* >> <:#286,9360><+!><:X11,-32768;TOC 2 "WHAT IS RLE?">WHAT IS RLE?<-!> <:#1430,9360>RLE stands for RUN LENGTH ENCODING. It is a quick simple data compression scheme which is commonly used for image data compression or compression of any data. Although not the most efficient system, it is fast, which is why it is used in image storage syste ms like PCX. This implementation is more efficient than the one used in PCX files because it uses 1 bit to identify a Run Length byte as opposed to two in PCX files, but more on this later. <:s><:#286,9360> <:s><:#572,9360>This set of functions can be used to implement your own compressed image file format or for example compress game maps for various levels etc. The uses are limited by your imagination. <:s><:#286,9360>I opted for trading off PCX RLE compatibility for the improved compression efficiency. <:s><:#286,9360> <:s><:#286,9360>Here is how the data is un-compressed to give an idea of its structure. <:s><:#286,9360> STEP 1 read a byte from the RLE compressed source buffer. <:s><:#286,9360> <:s><:#286,9360> STEP 2 If has its high bit is set then the lower 7 bits represent the number of times the next <:s><:#286,9360> byte is to be repeated in the destination buffer. If the count (lower 7 bits) is zero <:#286,9360> then we have finished decoding goto STEP 5 else goto STEP 4 <:s><:#286,9360> <:s><:#286,9360> STEP 3 Read a data from the source buffer and copy it directly to the destination buffer. <:s><:#286,9360> goto STEP 1 <:s><:#286,9360> <:s><:#286,9360> STEP 4 Read a data byte from the source buffer and copy it to the destination buffer the <:s><:#286,9360> number of times specified by step 2. goto STEP 1 <:s><:#286,9360> <:s><:#286,9360> STEP 5 Stop, decoding done. <:s><:#286,9360> <:#286,9360>If the byte does not have the high bit set then the byte itself is transferred to the destination buffer. <:#572,9360>Data bytes that have the high bit already set and are unique in the input stream are represented as a Run Length of 1 (i.e. 81 which includes high bit) followed by the data byte. <:s><:#286,9360> <:#1144,9360>If your original uncompressed data contains few consecutive bytes and most have high bit set (i.e. have values <;> 127) then your so called compressed data would require up to 2x the space of the uncompressed data, so be aware that the compression ratio is extremely variable depending on the type of data being compressed. <:s><:#286,9360> <:s><:#858,9360>Apologies for this poor attempt at a description, but you can look up RLE in any good text. Alternatively, any text that describes the PCX file structure in any depth should have a section on RLE compression. <:s><:#286,9360> <:s><:#286,9360> <:s><:p<* >> <:#286,9360><+!>WHAT IS DOUBLE BUFFERING ?<:X11,-32768;TOC 2 "WHAT IS DOUBLE BUFFERING ?"><-!> <:s><:#1430,9360>Double buffering (also known as page flipping) is the technique most often used to do animation. it requires hardware that is capable of displaying multiple graphics pages (or at least 2). Animation is achieved by drawing an image in the non visible screen and then displaying the non visible screen. Once the page has been flipped the process starts again. The next frame of the animation is drawn on the non visible screen, the page is flipped again etc. <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>WHAT IS TRIPLE BUFFERING?<-!><:X11,-32768;TOC 2 "WHAT IS TRIPLE BUFFERING?"> <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360> <:#286,9360><+!>WHAT IS A BEZIER CURVE?<:X11,-32768;TOC 2 "WHAT IS A BEZIER CURVE?"><-!> <:#1144,9360>The Bezier curve was developedd by the French mathematician Pierre Bezier for the design of automobiles. This curve is defined by four points: two end points and two control points. The curve begins at one end point, ends at the other end point, and uses the two control points to determine the curvature of the line. <:s><:#286,9360> <:s><:#286,9360><+!> <:s><:#286,9360> <:s><:#286,9360> <+@><:s><+!><:p<* >> <+B><:#286,9360><+!>The Care and Feeding of Compiled Masked Blits<:X11,-32768;TOC 2 "The Care and Feeding of Compiled Masked Blits"><-!> <+B><:s><:#286,9360>by Matthew MacKenzie <:s><:#286,9360> <:s><:#286,9360>The XCBITMAP module is small, containing only three procedures: <:s><:#293,9360> <+!><+">x_compile_bitmap<-"><-!> - Compiles your bitmap into native code which writes to the VGA <:s><:#286,9360> screen in an X mode. <:s><:#286,9360> <:s><:#293,9360> <+!><+">x_put_cbitmap<-"><-!> - Converts X and Y coordinates into a location on the screen, sets up the <:s><:#286,9360> necessary VGA registers, and executes the compiled bitmap as a <:s><:#286,9360> subroutine. <:s><:#286,9360> <:s><:#293,9360> <+!><+">x_sizeof_cbitmap<-"><-!> - Takes a planar bitmap and returns an integer equal to the size of the <:s><:#286,9360> compiled bitmap which the planar bitmap would produce. It is <:s><:#293,9360> essentially a lobotomized version of <+!><+">x_compile_bitmap<-"><-!>, with all <:s><:#286,9360> the code generation replaced with a size counter. <:s><:#286,9360> <:#2009,9360><+!><+">x_compile_bitmap<-"><-!> scans through a source bitmap and generates 8086 instructions to plot every non-zero pixel. It is designed to be used before the action begins rather than on-the-fly. The compiled bitmap contains no branches, and no referen ce to the zero (transparent) pixels. Where two pixels are exactly four columns apart they are plotted with a single 16-bit store, and the VGA MAP_MASK register will be set at most four times. As a result your bitmap may run several times faster than a tradi tional memory-to-VGA masked blit routine. There is no way to perform clipping on these bitmaps, or to plot a pixel of color zero. <:s><:#286,9360> <:#1151,9360><+!><+">x_compile_bitmap<-"><-!> works with bitmaps in the standard Xlib planar bitmap format. On a time scale of 60 frames per second, it is actually relatively slow. Since a compiled bitmap is relocatable you may just want to have it saved to disk, and no t include the source bitmap in your program at all. <:s><:#286,9360> <:s><:#286,9360>The source bitmap format is an array of bytes, a little like this: <:s><:#286,9360>char eye<[>] ={4, 7, /* four byte columns across, seven rows tall */ <:s><:#286,9360> 0, 0, 0, 0, 9, 1, 1, 1, 9, 0, 0, 0, 0, 0, 0, 0, <:s><:#286,9360> 0, 0, 9, 9, 1, 1, 1, 4, 4, 9, 9, 0, 0, 0, 0, 0, <:s><:#286,9360> 0, 9, 9, 1, 2, 0, 0, 4, 4, 1, 9, 9, 0, 0, 0, 0, <:s><:#286,9360> 9, 9, 9, 1, 0, 0, 0, 0, 1, 1, 9, 9, 9, 0, 0, 0, <:s><:#286,9360> 0, 9, 9, 1, 2, 0, 0, 2, 1, 1, 9, 9, 0, 0, 0, 0, <:s><:#286,9360> 0, 0, 9, 9, 1, 1, 1, 1, 1, 9, 9, 0, 0, 0, 0, 0, <:s><:#286,9360> 0, 0, 0, 0, 9, 1, 1, 1, 9, 0, 0, 0, 0, 0, 0, 0}; <:s><:#286,9360> <:s><:#572,9360>This is actually a linear bitmap, which is the wrong format for compilation, but is easier on human eyes. Use the module XBMTOOLS to convert linear bitmaps into planar bitmaps, and vice-versa. <:s><:#286,9360> <:s><:#286,9360>To compile this image for a mode 360 pixels (90 byte columns) across: <:#286,9360> char planar_eye<[>4*7 + 2]; <:#286,9360> char far * EyeSize; <:#286,9360> (void) x_bm_to_pbm((char far *) eye, (char far *) planar_eye); <:#286,9360> EyeSize = x_sizeof_cbitmap((far char *) planar_eye); <:#286,9360> CompiledEye = farmalloc(EyeSize); <:#286,9360> (void) x_compile_bitmap(90, (far char *) planar_eye, CompiledEye); <:s><:#286,9360> <:s><:#2016,9360>Notice that both buffers must exist beforehand. Since<+!><+"> x_compile_bitmap<-"><-!> returns the size of the compiled code, in bytes, you can reallocate the bitmap immediately to the right size if using <+!><+">x_sizeof_cbitmap<-"><-!> seems inconvenient (reallocation may even be faster, though using the function is cleaner). The pointers are 32-bit because compiled bitmaps take so much space: they are at one end of the speed-versus-memory spectrum. A good rule of thumb is to allocate (3.5 * buffer-height * buffer-width) + 25 bytes (rounding up), then pare your bitmap down when you find out how much space you've actually used. <:s><:#286,9360> <:s><:#1430,9360>Since the compiled bitmap has to fit within one segment of memory, it cannot contain more than about 19,000 pixels. This will not be a limitation for most sane programmers. If you are not a sane programmer try splitting your huge, unwieldy image up into sma ller parts. You can use the same gigantic bitmap if you divide it into horizontal slices for compilation. For that matter, dividing the source up that way will let you use a source bitmap large than 64K, which is an even sicker idea. <:s><:#286,9360> <:#1430,9360>Back to business. A bitmap is compiled for only one width of screen. If you are using a logical screen larger than your physical screen, call the bitmap compiler with the logical width. The important thing is the number of bytes per line. Notice that you do not have to be in a graphics mode to use this routine.This allows you to develop and compile bitmaps separately, with whatever utility programs you might cook up. <:#286,9360> <:s><:#293,9360>The final function is<+!><+"> x_put_cbitmap<-"><-!>. <:s><:#286,9360>To plot our eye at (99, 4), on the page which starts at location 0: <:#286,9360> x_put_cbitmap(99, 4, 0, CompiledEye); <:s><:#286,9360> <:s><:#579,9360>This function depends on the global variable <+">ScrnLogicalByteWidth<-"> from the module XMAIN, which should be the same number as the column parameter you used to compile your bitmap. <:s><:#286,9360> <:#858,9360>The XCBITMAP module supports memory-to-VGA blits only. XLIB also includes non-masking routines which can quickly save and restore the background screen behind your bitmap, using fast string operations. <:s><:#286,9360> <:#858,9360>This module is part of the XLIB package, and is in the public domain. If you write something which uses it, though, please send me a copy as a courtesy if for no other reason so I can tilt my chair back and reflect that it may have been worth the trouble a fter all. <:s><:#286,9360> <+B><:#286,9360>The included program DEMO2.C demonstrates the performance difference between planar bitmap <+@><:s> masked blits and compiled bitmap blits.<:p<* >> <+B><:#286,9360><+!>Blits and Pieces<:X11,-32768;TOC 2 "Blits and Pieces"><-!> <+B><:s><:#286,9360>by Matthew MacKenzie <:s><:#286,9360> <:s><:#572,9360>The XCLIPPBM module contains clipping versions of two of the three routines in the XPBITMAP module: <:s><:#286,9360> <:s><:#293,9360><+!><+">x_clip_pbm<-"><-!> - transfers a planar bitmap to the screen, clipping off any part outside a bounding box. <:#293,9360><+!><+">x_clip_masked_pbm<-"><-!> - does the same thing, but transfers only non-zero pixels. <:s><:#286,9360> <:s><:#572,9360>The planar bitmap format is described elsewhere. Here we will look at the clipping itself, since it is the only distinguishing feature of this module. <:s><:#286,9360> <:#872,9360>The bounding box is made up of four integers,<+"> TopBound, BottomBound, LeftBound,<-"> and <+">RightBound<-">. <+#>Unlike most global variables in XLIB, these are meant to be written to<-#>. In fact, they start out uninitialized. <+#>Be sure to set them before you try plotting any clipped bitmaps<-#>. <:#1430,9360>Note that these are not the same variables which are used in the other clipping modules in XLIB. This is because the two systems are incompatible: the other modules clip horizontally to columns while this one clips to pixels. As you might have guessed, tho se functions and these were developed in different hemispheres of the planet. If it's any consolation, this does give you two independent bounding boxes to futz with, should the mood visit you. <:s><:#286,9360> <:#1158,9360>Bitmaps cannot go outside the perimeter of the bounding box, but they can overlap it. If <+">TopBound<-"> equals <+">BottomBound<-">, for example, a horizontal slice of a bitmap may still be plotted. It is safe to turn the box "inside out" to make sure nothing will be plotted. This is the first thing each routine checks for. <:s><:#286,9360> <:s><:#286,9360>To plot a bitmap, minus its zero pixels, minus anything outside the bounding box: <:s><:#286,9360> <:s><:#293,9360><+!><+">x_clip_masked_pbm<-"><-!> (int X, int Y, int ScreenOffs, char far * Bitmap); <:s><:#286,9360> <:#1723,9360>The arguments are in the same order as those for <+!><+">x_put_masked_pbm<-"><-!> in the module XPBITMAP. The bounding box is relative to the given ScreenOffs ). This lets you perform page flipping without worrying about what screen you are clipping to it' s always the current screen. The bitmap itself, of course, is not affected; clipping is performed on-the-fly. Both functions return an integer which indicates whether any part of the bitmap was inside the bounding box. If the entire bitmap was outside, a 1 is returned; otherwise, a 0. <:s><:#286,9360> <:s>The third function in XPBITMAP, for which this module has no equivalent, copies from video RAM to system RAM. The absence of such a routine may seem at first like a disadvantage but this, like so many things in this life, is an illusion. You can use the un clipped routine, and clip the bitmap when you want to plot it back onto the screen.<:p<* >> <+B><:#286,9360><+!>Wheel Have to See About That<:X11,-32768;TOC 2 "Wheel Have to See About That"><-!> <+B><:s><:#286,9360>by Matthew MacKenzie <:s><:#286,9360> <:s><:#286,9360> <:s><:#286,9360>The XCIRCLE module contains two functions, neither of which should be a big mystery: <:#293,9360> <+!><+">x_circle<-"><-!>, oddly enough, draws a circle. <:#293,9360> <+!><+">x_filled_circle<-"><-!> does too, only the circle is filled (in some libraries this is called a disc). <:s><:#286,9360> <:#3725,9360>The word `circle' here refers to a round thing which is as many pixels tall as across. It only looks like a circle in 320x240 mode, the original mode X, and in 376x282 mode. In both functions, the circle is specified by the coordinates of the upper-left-han d corner of the smallest box which holds it, and the diameter. Some circle functions have you specify a center point; this system is kind of odd because a circle with an even diameter does not have a particular pixel for a center. Every circle, on the other hand, has a box with an upper-left corner. <+#>No bounds are checked<-#>. A diameter of zero will draw nothing, and a negative diameter will blow your VGA board into hundreds of thousands of tiny little smoldering fragments. Neither function supports clipp ing. The calculation of the circle is based on an algorithm described by Michael P. Lindner in a letter to the editor on page 8 of <+#>Dr. Dobb's Journal <-#>#169 (October 1990). The algorithm has been rearranged to allow drawing and moving the plots in the eight octants to be performed in one step, so that each pixel does not have to be loaded into the CPU twice. <+!><+"> x_filled_circle<-"><-!> does not take advantage of this optimization because it handles different parts of each plot at different times. <+@><:#286,9360> [Embedded] 00205799